다음을 통해 공유

SQLSetConfigMode 함수

  • 아티클

규칙
버전 소개: ODBC 3.0

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

구문

  
BOOL SQLSetConfigMode(  
     UWORD     wConfigMode);

인수

wConfigMode
[입력] 설치 관리자 구성 모드("주석" 참조). wConfigMode의 값은 다음과 같습니다.

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

반품

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

진단

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

*pfErrorCode Error 설명
ODBC_ERROR_INVALID_PARAM_SEQUENCE 잘못된 매개 변수 시퀀스 wConfigMode 인수에 ODBC_USER_DSN, ODBC_SYSTEM_DSN 또는 ODBC_BOTH_DSN 포함되지 않았습니다.

주석

이 함수는 DSN 값을 나열하는 Odbc.ini 항목이 시스템 정보에 있는 위치를 설정하는 데 사용됩니다. wConfigMode가 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 사용됩니다.

이 함수는 SQLCreateDataSource 및 SQLDriverConnect에 영향을 주지 않습니다. 드라이버가 SQLGetPrivateProfileString을 호출하여 레지스트리에서 읽거나 SQLWritePrivateProfileString을 호출하여 레지스트리에 쓸 때 구성 모드를 설정해야 합니다. SQLGetPrivateProfileString 및 SQLWritePrivateProfileString에 대한 호출은 구성 모드를 사용하여 작동할 레지스트리의 일부를 알 수 있습니다.

주의

SQLSetConfigMode 는 필요한 경우에만 호출해야 합니다. 모드가 잘못 설정된 경우 ODBC 설치 관리자가 제대로 작동하지 않을 수 있습니다.

SQLSetConfigMode 는 구성 모드를 직접 레지스트리로 수정합니다. SQLConfigDataSource를 호출하여 구성 모드를 수정하는 프로세스와는 다릅니다. SQLConfigDataSource에 대한 호출은 DSN을 수정할 때 사용자 및 시스템 DSN을 구분하는 구성 모드를 설정합니다. 반환 하기 전에 SQLConfigDataSource 는 구성 모드를 BOTHDSN으로 다시 설정합니다.

추가 정보 참조
데이터 소스 만들기 SQLCreateDataSource
연결 문자열 또는 대화 상자를 사용하여 데이터 원본에 연결 SQLDriverConnect
구성 모드 검색 SQLGetConfigMode