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 |