다음을 통해 공유


SQLGetConfigMode 함수

규칙
버전 소개: ODBC 3.0

요약
SQLGetConfigMode 는 DSN 값을 나열하는 Odbc.ini 항목이 시스템 정보에 있는 위치를 나타내는 구성 모드를 검색합니다.

구문

  
BOOL SQLGetConfigMode(  
     UWORD *   pwConfigMode);  

인수

pwConfigMode
[출력] 구성 모드를 포함하는 버퍼에 대한 포인터입니다. ("주석"을 참조하세요.) *pwConfigMode값은 다음과 같습니다.

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

반품

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

진단

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

*pfErrorCode Error 설명
ODBC_ERROR_OUT_OF_MEM 메모리 부족 메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

이 함수는 DSN 값을 나열하는 Odbc.ini 항목이 시스템 정보에 있는 위치를 결정하는 데 사용됩니다. *pwConfigMode가 ODBC_USER_DSN 경우 DSN은 사용자 DSN이고 함수는 HKEY_CURRENT_USER Odbc.ini 항목에서 읽습니다. ODBC_SYSTEM_DSN 경우 DSN은 시스템 DSN이고 함수는 HKEY_LOCAL_MACHINE Odbc.ini 항목에서 읽습니다. ODBC_BOTH_DSN 경우 HKEY_CURRENT_USER 시도되고 실패하면 HKEY_LOCAL_MACHINE 사용됩니다.

기본적으로 SQLGetConfigModeODBC_BOTH_DSN 반환합니다. SQLConfigDataSource를 호출하여 사용자 DSN 또는 시스템 DSN을 만들 때 함수는 구성 모드를 ODBC_USER_DSN 또는 ODBC_SYSTEM_DSN 설정하여 DSN을 수정하는 동안 사용자 및 시스템 DSN을 구분합니다. 반환 하기 전에 SQLConfigDataSource 는 구성 모드를 ODBC_BOTH_DSN 다시 설정합니다.

추가 정보 참조
구성 모드 설정 SQLSetConfigMode