GetSystemDefaultLocaleName 函式 (winnls.h)

注意建議應用程式在此函式的喜好設定上呼叫 GetUserDefaultLocaleName 。這是因為用戶地區設定通常比系統地區設定更實用且更精確。

注意如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該優先呼叫此函式給 GetSystemDefaultLCID 。

語法

int GetSystemDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

[out] lpLocaleName

這個函式擷取地區設定名稱之緩衝區的指標。

[in] cchLocaleName

大小，以字元為單位，為 lpLocaleName 所指示的輸出緩衝區。地區設定名稱的最大可能字元長度 (包括終止 null 字元) 是 LOCALE_NAME_MAX_LENGTH的值。這是建議的大小。

傳回大於 0 的值，指出地區設定名稱的長度，包括如果成功，則包含終止 Null 字元。

如果函式未成功，此函式會傳回 0。若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：

此函式可以從自定義地區設定擷取數據。數據不保證從計算機到計算機或在應用程式執行之間相同。如果您的應用程式必須保存或傳輸數據，請參閱使用持續性地區設定數據。

此函式的使用範例可在 NLS：名稱型 API 範例中找到。

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	winnls.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll