setLocaleInfoA 函式 (winnls.h)
設定目前地區設定之使用者覆寫部分的信息專案。 此函式不會設定系統預設值。
語法
BOOL SetLocaleInfoA(
[in] LCID Locale,
[in] LCTYPE LCType,
[in] LPCSTR lpLCData
);
參數
[in] Locale
針對函式的 ANSI 版本，地區設定的地區設定 標識碼 ，以及解譯 lpLCData 資訊時所使用的代碼頁。 針對 Unicode 版本，會忽略此參數。
您可以使用 MAKELCID 宏來建立地區設定標識碼，或使用下列其中一個預先定義的值。
也支援下列自定義地區設定標識碼。[in] LCType
要設定的地區設定信息類型。 For valid constants see "Constants Used in the LCType Parameter of GetLocaleInfo, GetLocaleInfoEx, and SetLocaleInfo" section of Locale Information Constants. 應用程式每個呼叫只能指定一個值，但可以使用二進位 OR 運算符來結合 LOCALE_USE_CP_ACP 與任何其他常數。
[in] lpLCData
Null 終止字串的指標，其中包含要設定的地區設定資訊。 信息必須是指定常數位有的格式。 應用程式會針對函式的 Unicode 版本使用 Unicode 字串，以及 ANSI 版本的 ANSI 字串。
傳回值
如果成功，則傳回非零值，否則傳回 0。 若要取得擴充的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：
- ERROR_ACCESS_DISABLED_BY_POLICY。 計算機或使用者的組策略已禁止此作業。
- ERROR_INVALID_ACCESS。 存取碼無效。
- ERROR_INVALID_FLAGS。 為旗標的值無效。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
備註
此函式會寫入登錄，其中會設定與特定使用者相關聯的值，而不是特定應用程式。 這些登錄值會影響使用者執行的其他應用程式行為。 一般來說，只有當用戶明確要求變更時，應用程式才應該呼叫此函式。 為了方便使用單一應用程式，不應變更登錄設定。
針對 LCType 參數，應用程式應該將 LOCALE_USE_CP_ACP 設定為使用作業系統 ANSI 代碼頁，而不是用於字串轉譯的地區設定代碼頁。
當此函式的 ANSI 版本與僅限 Unicode 的地區設定識別碼搭配使用時，函式可能會成功，因為操作系統使用系統代碼頁。 不過，系統代碼頁中未定義的字元會顯示在字串中，做為問號 (？) 。
從 Windows Vista 起， LOCALE_SDATE 和 LOCALE_STIME 常數已過時。 請勿使用這些常數。 請改用 LOCALE_SSHORTDATE 和 LOCALE_STIMEFORMAT 。 自定義地區設定在日期或時間格式內可能沒有單一的統一分隔符：例如，“12/31， 2006” 或 “03：56'23” 的格式可能有效。
注意
winnls.h 標頭會將 SetLocaleInfo 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | winnls.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |