writeProfileSectionW 函式 (winbase.h)
以指定的索引鍵和值取代 Win.ini 檔案中指定區段的內容。 如果 Win.ini 使用 Unicode 字元,函式會將 Unicode 字元寫入檔案。 否則,函式會寫入 ANSI 字元。
語法
BOOL WriteProfileSectionW(
[in] LPCWSTR lpAppName,
[in] LPCWSTR lpString
);
參數
[in] lpAppName
區段的名稱。 此區段名稱通常是呼叫應用程式的名稱。
[in] lpString
要寫入具名區段的新索引鍵名稱和相關聯的值。 此字串限制為 65,535 個位元組。
如果檔案存在且使用 Unicode 字元建立,函式會將 Unicode 字元寫入檔案。 否則,函式會使用 ANSI 字元建立檔案。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
lpString緩衝區中的索引鍵和值是由一或多個以 Null結尾的字串所組成,後面接著最後的Null字元。 每個字串都有下列形式:索引鍵=字串。
WriteProfileSection函式不區分大小寫;字串可以是大寫和小寫字母的組合。
WriteProfileSection 會刪除具名區段的現有索引鍵和值,並將索引鍵名稱和值插入 lpString所指向的緩衝區中。 函式不會嘗試相互關聯舊索引鍵名稱和新索引鍵名稱;如果新名稱的順序與舊名稱不同,則與初始化檔案中預先存在索引鍵和值相關聯的任何批註,可能會與不正確的索引鍵和值產生關聯。
此作業不可部分完成;寫入資訊時,不允許讀取或寫入初始化檔案的其他作業。
系統會保留最新登錄檔對應的快取版本,以改善效能。 如果所有參數都是 Null,則函式會排清快取。 當系統正在編輯快取的檔案版本時,編輯檔案本身的進程將會使用原始檔案,直到清除快取為止。
系統會使用下列登錄機碼下定義的對應,將大部分 .ini 檔案參考對應至登錄:
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows NT CurrentVersion IniFileMapping
當作業已對應時, WriteProfileSection 函式會將資訊寫入登錄,而不是初始化檔案;儲存位置中的變更不會影響函式的行為。
設定檔函式會使用下列步驟來找出初始化資訊:
- 在登錄中尋找 IniFileMapping 機碼下初始化檔案的名稱。
- 尋找 lpAppName所指定的區段名稱。 這會是索引鍵底下的具名值,其名稱為初始化檔的名稱,或是具有此名稱的子機碼,或名稱不存在為值或子機碼。
- 如果 lpAppName 指定的區段名稱是具名值,則該值會指定登錄中的位置,您會找到區段的機碼。
- 如果 lpAppName 指定的區段名稱是子機碼,則該子機碼下的具名值會指定登錄中的位置,您會找到區段的機碼。 如果您要尋找的機碼不存在為具名值,則會有未命名的值, (顯示為< [無名稱 >]) ,指定您在登錄中找到金鑰的預設位置。
- 如果lpAppName指定的區段名稱不存在為具名值或子機碼,則會有未命名的值 (顯示為< [無名稱 >]) ,指定您在登錄中找到區段索引鍵的預設位置。
- 如果沒有區段名稱的子機碼或專案,請尋找磁片上的實際初始化檔案,並讀取其內容。
- ! - 此字元會強制所有寫入至登錄和磁片上的 .ini 檔案。
- # - 當新使用者第一次在安裝之後登入時,此字元會使登錄值設定為 Windows 3.1 .ini 檔案中的值。
- @ - 如果登錄中找不到要求的資料,此字元可防止任何讀取移至磁片上的 .ini 檔案。
- USR: - 此前置詞代表 HKEY_CURRENT_USER,且前置詞之後的文字相對於該索引鍵。
- SYS:- 此前置詞代表 HKEY_LOCAL_MACHINE\SOFTWARE,而前置詞之後的文字則相對於該索引鍵。
注意
winbase.h 標頭會將 WriteProfileSection 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winbase.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |