SQLWritePrivateProfileString 함수

규칙
버전 소개: ODBC 2.0

요약
SQLWritePrivateProfileString 은 시스템 정보의 Odbc.ini 하위 키에 값 이름과 데이터를 씁니다.

구문

  
BOOL SQLWritePrivateProfileString(  
     LPCSTR     lpszSection,  
     LPCSTR     lpszEntry,  
     LPCSTR     lpszString,  
     LPCSTR     lpszFilename);  

인수

lpszSection
[입력] 문자열을 복사할 섹션의 이름을 포함하는 null로 끝나는 문자열을 가리킵니다. 섹션이 없으면 만들어집니다. 섹션의 이름은 대/소문자를 구분합니다. 문자열은 대문자와 소문자의 조합일 수 있습니다.

lpszEntry
[입력] 문자열과 연결할 키의 이름을 포함하는 null로 끝나는 문자열을 가리킵니다. 지정된 섹션에 키가 없으면 키가 만들어집니다. 이 인수가 NULL이면 섹션 내의 모든 항목을 포함하여 전체 섹션이 삭제됩니다.

lpszString
[입력] 파일에 쓸 null로 끝나는 문자열을 가리킵니다. 이 인수가 NULL이면 lpszEntry 인수가 가리키는 키가 삭제됩니다.

lpszFilename
[출력] 초기화 파일의 이름을 지정하는 null로 끝나는 문자열을 가리킵니다.

반품

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

진단

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

*pfErrorCode	오류	설명
ODBC_ERROR_GENERAL_ERR	일반 설치 관리자 오류	특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_REQUEST_FAILED	요청 실패	요청된 시스템 정보를 쓸 수 없습니다.
ODBC_ERROR_OUT_OF_MEM	메모리 부족	메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

설명

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

구성 모드는 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 사용됩니다.

관련 함수

추가 정보	참조
시스템 정보에서 값 가져오기	SQLGetPrivateProfileString