SQLConfigDriver 함수

규칙
버전 소개: ODBC 2.5

요약
SQLConfigDriver는 적절한 드라이버 설정 DLL을 로드하고 ConfigDriver 함수를 호출합니다.

ODBCCONF.EXE를 사용하여 SQLConfigDriver의 기능에 액세스할 수도 있습니다.

구문

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

인수

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

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

ODBC_CONFIG_DRIVER: 드라이버에서 사용하는 연결 풀링 시간 제한을 변경합니다.

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

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

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

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

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

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

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

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

반품

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

진단

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

*pfErrorCode	Error	설명
ODBC_ERROR_GENERAL_ERR	일반 설치 관리자 오류	특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_INVALID_BUFF_LEN	버퍼 길이가 잘못되었습니다.	lpszMsg 인수가 잘못되었습니다.
ODBC_ERROR_INVALID_HWND	잘못된 창 핸들	hwndParent 인수가 잘못되었습니다.
ODBC_ERROR_INVALID_REQUEST_TYPE	잘못된 요청 유형	fRequest 인수는 다음 중 하나가 아닙니다. ODBC_INSTALL_DRIVER ODBC_REMOVE_DRIVER fRequest 인수는 ODBC_CONFIG_DRIVER_MAX 작거나 같은 드라이버별 옵션입니다.
ODBC_ERROR_INVALID_NAME	드라이버 또는 번역기 이름이 잘못되었습니다.	lpszDriver 인수가 잘못되었습니다. 레지스트리에서 찾을 수 없습니다.
ODBC_ERROR_INVALID_KEYWORD_VALUE	잘못된 키워드-값 쌍	lpszArgs 인수에 구문 오류가 포함되어 있습니다.
ODBC_ERROR_REQUEST_FAILED	요청 실패	설치 관리자가 fRequest 인수에서 요청한 작업을 수행할 수 없습니다. ConfigDriver에 대한 호출이 실패했습니다.
ODBC_ERROR_LOAD_LIBRARY_FAILED	드라이버 또는 번역기 설치 라이브러리를 로드할 수 없음	드라이버 설치 라이브러리를 로드할 수 없습니다.
ODBC_ERROR_OUT_OF_MEM	메모리 부족	메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

SQLConfigDriver 를 사용하면 애플리케이션에서 이름을 알 필요 없이 드라이버의 ConfigDriver 루틴을 호출하고 드라이버별 설치 DLL을 로드할 수 있습니다. 설치 프로그램은 드라이버 설치 DLL이 설치된 후 이 함수를 호출합니다. 호출 프로그램은 이 함수를 모든 드라이버에서 사용할 수 없다는 점에 유의해야 합니다. 이러한 경우 호출 프로그램은 오류 없이 계속되어야 합니다.

드라이버별 옵션

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

연결 풀링 시간 제한 설정

드라이버의 구성을 설정할 때 연결 풀링 시간 제한 속성을 설정할 수 있습니다. SQLConfigDriver는 cPTimeout으로 설정된 ODBC_CONFIG_DRIVER 및 lpszArgs의 fRequest를 사용하여 호출됩니다. CPTimeout 은 연결이 사용되지 않고 연결 풀에 남아 있을 수 있는 기간을 결정합니다. 시간 제한이 만료되면 연결이 닫히고 풀에서 제거됩니다. 기본 시간 제한은 60초입니다.

fRequest를 ODBC_INSTALL_DRIVER 또는 ODBC_REMOVE_DRIVER 설정하여 SQLConfigDriver를 호출하면 드라이버 관리자가 적절한 드라이버 설정 DLL을 로드하고 ConfigDriver 함수를 호출합니다. ODBC_CONFIG_DRIVER fRequest를 사용하여 SQLConfigDriver를 호출하면 드라이버 설치 DLL을 로드할 필요가 없도록 모든 처리가 ODBC 설치 관리자에서 수행됩니다.

메시지

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

관련 함수

추가 정보	참조
드라이버 추가, 수정 또는 제거	ConfigDriver(설치 DLL에서)
기본 데이터 원본 제거	SQLRemoveDefaultDataSource