IsValidLocaleName 関数 (winnls.h)

オペレーティングシステムにインストールまたはサポートされているロケールに対して、指定したロケール名が有効かどうかを判断します。

メモ Windows Vista 以降でのみ実行されているアプリケーションでは、 IsValidLocale を優先してこの関数を呼び出して、補足ロケールの有効性を判断する必要があります。

構文

BOOL IsValidLocaleName(
  [in] LPCWSTR lpLocaleName
);

[in] lpLocaleName

検証するロケール名へのポインター。

ロケール名が有効な場合は 0 以外の値を返し、無効な名前の場合は 0 を返します。

Windows Vista 以降では、サポートされているすべてのロケールをすべてのオペレーティングシステムにインストールする必要があります。

この関数は、カスタムロケールの名前を処理できます。データは、コンピューター間、またはアプリケーションの実行間で同じになることは保証されません。アプリケーションでデータを永続化または送信する必要がある場合は、「永続的なロケールデータの使用」を参照してください。

Windows 8 以降: アプリが Windows.Globalization 名前空間からこの関数に言語タグを渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	winnls.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll