GetUserDefaultLocaleName 函式 (winnls.h)

擷取用戶預設 的地區設定名稱

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

 

語法

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

參數

[out] lpLocaleName

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

[in] cchLocaleName

大小,以字元為單位,代表 lpLocaleName 的緩衝區。 地區設定名稱的可能長度上限,包括終止的 Null 字元為 LOCALE_NAME_MAX_LENGTH。 這是在此參數中提供的建議大小。

傳回值

如果成功,則傳回包含地區設定名稱的緩衝區大小,包括終止 Null 字元。

注意 在單一用戶系統上,傳回值與 GetSystemDefaultLocaleName 所傳回的值相同。

 

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

  • ERROR_INSUFFICIENT_BUFFER。 提供的緩衝區大小不夠大,或設定為 NULL 不正確。

備註

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

規格需求

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

另請參閱

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

國家語言支援

國家語言支援函式