WriteProfileSectionA 函式 （winbase.h）
以指定的索引鍵和值取代 Win.ini 檔案中指定區段的內容。 如果 Win.ini 使用 Unicode 字元，函式會將 Unicode 字元寫入檔案。 否則，函式會寫入 ANSI 字元。
語法
BOOL WriteProfileSectionA(
[in] LPCSTR lpAppName,
[in] LPCSTR 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 標頭會根據 UNICODE 預處理器常數的定義，將 WriteProfileSection 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winbase.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |