GetSystemDefaultLocaleName

システム既定ロケール名を取得する。注意 アプリケーションは GetUserDefaultLocaleName をこの関数より優先して呼び出すことが推奨される。

GetSystemDefaultLocaleName lpLocaleName, cchLocaleName

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

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

解説

システム既定ロケール名を取得する。注意 アプリケーションは GetUserDefaultLocaleName
をこの関数より優先して呼び出すことが推奨される。

[戻り値]
成功した場合、終端 null 文字を含むロケール名の長さを示す 0 より大きい値を返す。成功しなかった場合、関数は 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