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