GetUserDefaultLocaleName

ユーザー既定ロケール名を取得する。注意 Windows Vista 以降のみで動作するように設計されているアプリケーションは、GetUserDefaultLCID よりもこの関数を優先して呼び出すべきである。

GetUserDefaultLocaleName lpLocaleName, cchLocaleName

lpLocaleName : [wstr] この関数がロケール名を取得するバッファへのポインタ。
cchLocaleName : [int] lpLocaleName が示すバッファのサイズ(文字数)。終端 null 文字を含むロケール名の最大可能長は LOCALE_NAME_MAX_LENGTH である。これがこのパラメータに指定する推奨サイズである。

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

解説

ユーザー既定ロケール名を取得する。注意 Windows Vista
以降のみで動作するように設計されているアプリケーションは、GetUserDefaultLCID
よりもこの関数を優先して呼び出すべきである。

[戻り値]
成功した場合、終端 null 文字を含むロケール名を含むバッファのサイズを返す。注意 シングルユーザーシステムでは、戻り値は
GetSystemDefaultLocaleName が返すものと同じである。
成功しなかった場合、関数は 0 を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼ぶ。これは以下のいずれかのエラーコードを返す。
(以下省略)

[備考]

この関数はカスタムロケールからデータを取得できる。データはコンピュータ間やアプリケーションの実行間で同じであることは保証されない。アプリケーションがデータを永続化または送信する必要がある場合は、Using
Persistent Locale Data を参照。

情報

プラグイン / モジュール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