IsValidLocaleName

指定したロケール名が OS にインストール済みまたはサポート済みのロケールに対して有効かを判定する。注: Windows Vista 以降のみで動作するアプリケーションは、補助ロケールの有効性判定のために IsValidLocale より先にこの関数を呼ぶべきである。

IsValidLocaleName lpLocaleName

lpLocaleName : [wstr] 検証するロケール名へのポインタ。

(プラグイン / モジュール : kernel32.dll)

解説

指定したロケール名が OS にインストール済みまたはサポート済みのロケールに対して有効かを判定する。注: Windows Vista
以降のみで動作するアプリケーションは、補助ロケールの有効性判定のために IsValidLocale より先にこの関数を呼ぶべきである。

[戻り値]
ロケール名が有効であれば 0 以外の値を、無効であれば 0 を返す。

[備考]
Windows Vista 以降では、サポートされるロケールはすべての OS にインストールされているべきである。この関数はカスタム
ロケールの名前を扱える。データがコンピュータ間やアプリケーションの実行間で同じである保証はない。アプリケーションがデータを永続化または送信する必要がある場合は
Using Persistent Locale Data を参照のこと。Windows 8 以降: アプリケーションが
Windows.Globalization 名前空間から言語タグをこの関数に渡す場合、まず ResolveLocaleName
を呼んでタグを変換しなければならない。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs