다음을 통해 공유

SQLGetInstalledDrivers 함수

  • 아티클

규칙
버전 소개: ODBC 1.0

요약
SQLGetInstalledDrivers 는 시스템 정보의 [ODBC 드라이버] 섹션을 읽고 설치된 드라이버에 대한 설명 목록을 반환합니다.

구문

  
BOOL SQLGetInstalledDrivers(  
     LPSTR   lpszBuf,  
     WORD    cbBufMax,  
     WORD *  pcbBufOut);

인수

lpszBuf
[출력] 설치된 드라이버에 대한 설명 목록입니다. 목록 구조에 대한 자세한 내용은 "설명"을 참조하세요.

cbBufMax
[입력] lpszBuf의 길이입니다.

pcbBufOut
[출력] lpszBuf에서 반환된 총 바이트 수(null 종료 바이트 제외)입니다. 반환할 수 있는 바이트 수가 cbBufMax보다 크거나 같으면 lpszBuf의 드라이버 설명 목록이 cbBufMax에서 null 종료 문자를 뺀 값으로 잘립니다. pcbBufOut 인수는 null 포인터일 수 있습니다.

반품

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

진단

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

*pfErrorCode Error 설명
ODBC_ERROR_GENERAL_ERR 일반 설치 관리자 오류 특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_INVALID_BUFF_LEN 버퍼 길이가 잘못되었습니다. lpszBuf 인수가 NULL이거나 잘못되었거나 cbBufMax 인수가 0보다 작거나 같습니다.
ODBC_ERROR_COMPONENT_NOT_FOUND 레지스트리에서 구성 요소를 찾을 수 없음 설치 관리자가 레지스트리에서 [ODBC 드라이버] 섹션을 찾을 수 없습니다.
ODBC_ERROR_OUT_OF_MEM 메모리 부족 메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

각 드라이버 설명은 null 바이트로 종료되고 전체 목록은 null 바이트로 종료됩니다. 즉, 2개의 null 바이트가 목록의 끝을 표시합니다. 할당된 버퍼가 전체 목록을 저장할 만큼 충분히 크지 않으면 목록이 오류 없이 잘립니다. null 포인터가 lpszBuf로 전달되면 오류가 반환됩니다.

추가 정보 참조
드라이버 설명 및 특성 반환 SQLDrivers