다음을 통해 공유

SQLGetPrivateProfileString 함수

  • 아티클

규칙
버전 소개: ODBC 2.0

요약
SQLGetPrivateProfileString 은 시스템 정보의 값에 해당하는 값 또는 데이터의 이름 목록을 가져옵니다.

구문

  
int SQLGetPrivateProfileString(  
     LPCSTR   lpszSection,  
     LPCSTR   lpszEntry,  
     LPCSTR   lpszDefault,  
     LPCSTR   RetBuffer,  
     INT      cbRetBuffer,  
     LPCSTR   lpszFilename);

인수

lpszSection
[입력] 키 이름을 포함하는 섹션을 지정하는 null로 끝나는 문자열을 가리킵니다. 이 인수가 NULL이면 함수는 파일의 모든 섹션 이름을 제공된 버퍼에 복사합니다.

lpszEntry
[입력] 연결된 문자열을 검색할 키 이름을 포함하는 null로 끝나는 문자열을 가리킵니다. 이 인수가 NULL이면 lpszSection 인수로 지정된 섹션의 모든 키 이름이 RetBuffer 인수로 지정된 버퍼에 복사됩니다.

lpszDefault
[입력] 초기화 파일에서 키를 찾을 수 없는 경우 지정된 키의 기본값을 지정하는 null로 끝나는 문자열을 가리킵니다. 이 인수는 NULL일 수 없습니다.

RetBuffer
[출력] 검색된 문자열을 받는 버퍼를 가리킵니다.

cbRetBuffer
[입력] RetBuffer 인수가 가리키는 버퍼의 크기를 문자 단위로 지정합니다.

lpszFilename
[입력] 초기화 파일의 이름을 지정하는 null로 끝나는 문자열을 가리킵니다. 이 인수에 파일의 전체 경로가 없으면 기본 디렉터리가 검색됩니다.

반품

SQLGetPrivateProfileString 은 읽은 문자 수를 나타내는 정수 값을 반환합니다.

진단

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

*pfErrorCode 오류 설명
ODBC_ERROR_GENERAL_ERR 일반 설치 관리자 오류 특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_OUT_OF_MEM 메모리 부족 메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

설명

SQLGetPrivateProfileString 은 Microsoft Windows에서 Microsoft Windows NT/Windows 2000으로 드라이버 및 드라이버 설정 DLL을 포팅하는 간단한 방법으로 제공됩니다. Odbc.ini 파일에서 프로필 문자열을 검색하는 GetPrivateProfileString에 대한 호출은 SQLGetPrivateProfileString에 대한 호출로 바꿔야 합니다. SQLGetPrivateProfileString 은 Win32 API의 함수를 호출하여 시스템 정보의 Odbc.ini 하위 키 값에 해당하는 값 또는 데이터의 요청된 이름을 검색합니다.

구성 모드(SQLSetConfigMode에서 설정)는 DSN 값을 나열하는 Odbc.ini 항목이 시스템 정보에 있는 위치를 나타냅니다. DSN이 사용자 DSN(구성 모드가 USERDSN_ONLY)인 경우 함수는 HKEY_CURRENT_USER Odbc.ini 항목에서 읽습니다. DSN이 시스템 DSN(SYSTEMDSN_ONLY)인 경우 함수는 HKEY_LOCAL_MACHINE Odbc.ini 항목에서 읽습니다. 구성 모드가 BOTHDSN인 경우 HKEY_CURRENT_USER 시도되고 실패하면 HKEY_LOCAL_MACHINE 사용됩니다.

추가 정보 참조
시스템 정보에 값 작성 SQLWritePrivateProfileString