IsValidLocaleName 関数 (winnls.h)
オペレーティング システムにインストールまたはサポートされているロケールに対して、指定したロケール 名 が有効かどうかを判断します。
メモ Windows Vista 以降でのみ実行されているアプリケーションでは、 IsValidLocale を優先してこの関数を呼び出して 、補足ロケールの有効性を判断する必要があります。
構文
BOOL IsValidLocaleName(
[in] LPCWSTR lpLocaleName
);
パラメーター
[in] lpLocaleName
検証するロケール名へのポインター。
戻り値
ロケール名が有効な場合は 0 以外の値を返し、無効な名前の場合は 0 を返します。
解説
Windows Vista 以降では、サポートされているすべてのロケールをすべてのオペレーティング システムにインストールする必要があります。
この関数は、 カスタム ロケールの名前を処理できます。 データは、コンピューター間、またはアプリケーションの実行間で同じになることは保証されません。 アプリケーションでデータを永続化または送信する必要がある場合は、「 永続的なロケール データの使用」を参照してください。
Windows 8 以降: アプリが Windows.Globalization 名前空間からこの関数に言語タグを渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。
例
この関数の使用方法を示す例については、「 NLS: 名前ベースの API サンプル」を参照してください。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnls.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |