SQLInstallDriverManager 함수

규칙
버전 소개: ODBC 1.0: Windows XP 서비스 팩 2, Windows Server 2003 서비스 팩 1 이상 운영 체제에서 사용되지 않음

요약
SQLInstallDriverManager 는 ODBC 핵심 구성 요소 설치에 대한 대상 디렉터리의 경로를 반환합니다. 호출 프로그램은 실제로 드라이버 관리자의 파일을 대상 디렉터리에 복사해야 합니다.

구문

  
BOOL SQLInstallDriverManager(  
     LPSTR    lpszPath,  
     WORD     cbPathMax,  
     WORD *   pcbPathOut);  

인수

lpszPath
[출력] 설치 대상 디렉터리의 경로입니다.

cbPathMax
[입력] lpszPath의 길이입니다. 최소 _MAX_PATH 바이트여야 합니다.

pcbPathOut
[출력] lpszPath에서 반환된 총 바이트 수(null 종료 바이트 제외)입니다. 반환할 수 있는 바이트 수가 cbPathMax보다 크거나 같으면 lpszPath의 경로가 cbPathMax에서 null 종료 문자를 뺀 값으로 잘립니다. pcbPathOut 인수는 null 포인터일 수 있습니다.

반품

이 함수는 성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

진단

SQLInstallDriverManager가 FALSE를 반환하면 SQLInstallerError를 호출하여 연결된 *pfErrorCode 값을 가져올 수 있습니다. 다음 표에서는 SQLInstallerError에서 반환할 수 있는 *pfErrorCode 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다.

*pfErrorCode	Error	설명
ODBC_ERROR_GENERAL_ERR	일반 설치 관리자 오류	특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_INVALID_BUFF_LEN	버퍼 길이가 잘못되었습니다.	lpszPath 인수가 출력 경로를 포함할 만큼 크지 않았습니다. 버퍼에는 잘린 경로가 포함됩니다. cbPathMax 인수가 _MAX_PATH 미만이었습니다.
ODBC_ERROR_USAGE_UPDATE_FAILED	구성 요소 사용 횟수를 증가 또는 감소시킬 수 없습니다.	설치 관리자가 ODBC 핵심 구성 요소 사용 횟수를 증가하지 못했습니다.
ODBC_ERROR_OUT_OF_MEM	메모리 부족	메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

SQLInstallDriverManager 는 ODBC 핵심 구성 요소의 경로를 반환하고 시스템 정보의 구성 요소 사용 횟수를 증가하기 위해 호출됩니다. 드라이버 관리자 버전이 이미 있지만 드라이버의 구성 요소 사용 횟수가 없는 경우 새 구성 요소 사용량 개수 값은 2로 설정됩니다.

애플리케이션 설치 프로그램은 핵심 구성 요소 파일을 물리적으로 복사하고 파일 사용 횟수를 유지 관리합니다. 핵심 구성 요소 파일이 이전에 설치되지 않은 경우 애플리케이션 설치 프로그램에서 파일을 복사하고 파일 사용 횟수를 만들어야 합니다. 파일이 이전에 설치된 경우 설치 프로그램은 파일 사용 횟수만 증가합니다.

이전에 애플리케이션 설치 프로그램에서 이전 버전의 드라이버 관리자를 설치한 경우 핵심 구성 요소를 제거한 다음 다시 설치해야 핵심 구성 요소 사용 횟수가 유효합니다. 먼저 구성 요소 사용 횟수를 감소하기 위해 SQLRemoveDriverManager 를 호출해야 합니다. 그런 다음, 구성 요소 사용 횟수를 증가하기 위해 SQLInstallDriverManager 를 호출해야 합니다. 애플리케이션 설치 프로그램은 이전 핵심 구성 요소 파일을 새 파일로 바꿔야 합니다. 파일 사용 횟수는 동일하게 유지되며 이전 버전 코어 구성 요소 파일을 사용한 다른 애플리케이션은 이제 최신 버전 파일을 사용합니다.

ODBC 핵심 구성 요소, 드라이버 및 번역기를 새로 설치할 때 애플리케이션 설치 프로그램은 SQLInstallDriverManager, SQLInstallDriverEx, SQLConfigDriver(ODBC_INSTALL_DRIVER fRequest 사용) 및 SQLInstallTranslatorEx 함수를 순서대로 호출해야 합니다. 핵심 구성 요소, 드라이버 및 번역기를 제거할 때 애플리케이션 설치 프로그램은 SQLRemoveTranslator, SQLRemoveDriver 및 SQLRemoveDriverManager 함수를 순서대로 호출해야 합니다. 이러한 함수는 이 시퀀스에서 호출해야 합니다. 모든 구성 요소를 업그레이드할 때 모든 제거 함수를 순서대로 호출한 다음 모든 설치 함수를 순서대로 호출해야 합니다.

관련 함수

추가 정보	참조
드라이버 추가, 수정 또는 제거	SQLConfigDriver
드라이버 설치	SQLInstallDriverEx
번역기 설치	SQLInstallTranslatorEx
드라이버 제거	SQLRemoveDriver
드라이버 관리자 제거	SQLRemoveDriverManager
번역기 제거	SQLRemoveTranslator