IsValidLocaleName 函式 (winnls.h)
判斷指定的 地區設定名稱 是否適用于作業系統上安裝或支援的地區設定。
注意 只有在 Windows Vista 和更新版本上執行的應用程式應該以 IsValidLocale 的喜好設定呼叫此函式,以判斷 補充地區設定的有效性。
語法
BOOL IsValidLocaleName(
[in] LPCWSTR lpLocaleName
);
參數
[in] lpLocaleName
要驗證的地區設定名稱指標。
傳回值
如果地區設定名稱有效,則傳回非零值,或針對不正確名稱傳回 0。
備註
在 Windows Vista 和更新版本上,所有支援的地區設定都應該安裝在所有作業系統上。
此函式可以處理 自訂地區設定的名稱。 資料不保證從電腦到電腦或在應用程式執行之間相同。 如果您的應用程式必須保存或傳輸資料,請參閱 使用持續性地區設定資料。
從 Windows 8 開始: 如果您的 app 會從 Windows.Globalization 命名空間將語言標記傳遞至此函式,則必須先呼叫 ResolveLocaleName來轉換標記。
範例
此函式的使用範例可在 NLS:名稱型 API 範例中找到。
規格需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | winnls.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |