setLocaleInfoA 函式 (winnls.h)

設定目前地區設定之使用者覆寫部分的信息專案。 此函式不會設定系統預設值。

謹慎由於此函式會修改所有應用程式的值，因此只能由 控制台 或類似公用程式的地區和語言選項功能呼叫。 如果對系統參數進行國際變更，呼叫應用程式必須廣播 WM_SETTINGCHANGE 訊息，以避免在其他應用程式中造成不穩定。

 

語法

BOOL SetLocaleInfoA(
  [in] LCID   Locale,
  [in] LCTYPE LCType,
  [in] LPCSTR lpLCData
);

參數

[in] Locale

針對函式的 ANSI 版本，地區設定的地區設定 標識碼 ，以及解譯 lpLCData 資訊時所使用的代碼頁。 針對 Unicode 版本，會忽略此參數。

您可以使用 MAKELCID 宏來建立地區設定標識碼，或使用下列其中一個預先定義的值。

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

也支援下列自定義地區設定標識碼。

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[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

另請參閱

GetLocaleInfo

國家語言支援

國家語言支援函式