共用方式為


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 是以將驅動程式和驅動程式設定 DLL 從 Microsoft Windows 移植到 Microsoft Windows NT/Windows 2000 的簡單方式提供。 呼叫 WritePrivateProfileString,以呼叫 SQLWritePrivateProfileString,將配置檔字串寫入Odbc.ini檔案。 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