ConfigDriver 함수

규칙
버전 소개: ODBC 2.5

요약
ConfigDriver를 사용하면 설치 프로그램이 ConfigDSN을 호출할 필요 없이 설치 및 제거 함수를 수행할 수 있습니다. 이 함수는 드라이버 관련 시스템 정보 만들기 및 설치 중 DSN 변환 수행, 제거 중 시스템 정보 수정 정리와 같은 드라이버 관련 함수를 수행합니다. 이 함수는 드라이버 설치 DLL 또는 별도의 설치 DLL에 의해 노출됩니다.

구문

  
BOOL ConfigDriver(  
      HWND    hwndParent,  
      WORD    fRequest,  
      LPCSTR  lpszDriver,  
      LPCSTR  lpszArgs,  
      LPSTR   lpszMsg,  
      WORD    cbMsgMax,  
      WORD *  pcbMsgOut);  

인수

hwndParent
[입력] 부모 창 핸들입니다. 핸들이 null인 경우 함수는 대화 상자를 표시하지 않습니다.

fRequest
[입력] 요청 유형입니다. fRequest 인수는 다음 값 중 하나를 포함해야 합니다.

ODBC_INSTALL_DRIVER: 새 드라이버를 설치합니다.

ODBC_REMOVE_DRIVER: 드라이버를 제거합니다.

이 옵션은 드라이버별로 지정할 수도 있습니다. 이 경우 첫 번째 옵션에 대한 fRequest 인수는 ODBC_CONFIG_DRIVER_MAX+1부터 시작해야 합니다. 추가 옵션에 대한 fRequest 인수도 ODBC_CONFIG_DRIVER_MAX+1보다 큰 값에서 시작해야 합니다.

lpszDriver
[입력] 시스템 정보의 Odbcinst.ini 키에 등록된 드라이버의 이름입니다.

lpszArgs
[입력] 드라이버별 fRequest에 대한 인수를 포함하는 null로 끝나는 문자열입니다.

lpszMsg
[출력] 드라이버 설정의 출력 메시지를 포함하는 null로 끝나는 문자열입니다.

cbMsgMax
[입력] lpszMsg의 길이입니다.

pcbMsgOut
[출력] lpszMsg에서 반환할 수 있는 총 바이트 수입니다.

반환할 수 있는 바이트 수가 cbMsgMax보다 크거나 같으면 lpszMsg의 출력 메시지가 cbMsgMax에서 null 종료 문자를 뺀 값으로 잘립니다. pcbMsgOut 인수는 null 포인터일 수 있습니다.

반품

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

진단

ConfigDriver가 FALSE를 반환하면 연결된 *pfErrorCode 값이 SQLPostInstallerError를 호출하여 설치 관리자 오류 버퍼에 게시되고 SQLInstallerError를 호출하여 가져올 수 있습니다. 다음 표에서는 SQLInstallerError에서 반환할 수 있는 *pfErrorCode 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다.

*pfErrorCode	Error	설명
ODBC_ERROR_INVALID_HWND	잘못된 창 핸들	hwndParent 인수가 잘못되었습니다.
ODBC_ERROR_INVALID_REQUEST_TYPE	잘못된 요청 유형	fRequest 인수는 다음 중 하나가 아닙니다. ODBC_INSTALL_DRIVER ODBC_REMOVE_DRIVER 드라이버 관련 옵션이 ODBC_CONFIG_DRIVER_MAX 작거나 같음
ODBC_ERROR_INVALID_NAME	드라이버 또는 번역기 이름이 잘못되었습니다.	lpszDriver 인수가 잘못되었습니다. 레지스트리에서 찾을 수 없습니다.
ODBC_ERROR_REQUEST_FAILED	요청 실패	fRequest 인수에서 요청한 작업을 수행할 수 없습니다.
ODBC_ERROR_DRIVER_SPECIFIC	드라이버 또는 번역기 관련 오류	정의된 ODBC 설치 관리자 오류가 없는 드라이버 관련 오류입니다. SQLPostInstallerError 함수 호출의 SzError 인수에는 드라이버 관련 오류 메시지가 포함되어야 합니다.

주석

드라이버별 옵션

애플리케이션은 fRequest 인수를 사용하여 드라이버에서 노출하는 드라이버 관련 기능을 요청할 수 있습니다. 첫 번째 옵션에 대한 fRequest는 ODBC_CONFIG_DRIVER_MAX 더하기 1이고 추가 옵션은 해당 값에서 1씩 증가합니다. 해당 함수에 대한 드라이버에 필요한 모든 인수는 lpszArgs 인수에 전달된 null로 끝나는 문자열에 제공되어야 합니다. 이러한 기능을 제공하는 드라이버는 드라이버별 옵션 테이블을 유지해야 합니다. 옵션은 드라이버 설명서에 완전히 문서화되어야 합니다. 드라이버 관련 옵션을 사용하는 애플리케이션 작성자는 이를 통해 애플리케이션의 상호 운용성이 떨어지게 된다는 것을 알고 있어야 합니다.

메시지

드라이버 설정 루틴은 lpszMsg 버퍼에서 null로 끝나는 문자열로 애플리케이션에 문자 메시지를 보낼 수 있습니다. 메시지가 cbMsgMax 문자보다 크거나 같은 경우 ConfigDriver 함수에서 null 종료 문자를 뺀 cbMsgMax로 잘립니다.