GetProfileIntW

Win.ini ファイルの指定セクション内のキーから整数を取得する。(Unicode)

GetProfileIntW lpAppName, lpKeyName, nDefault

lpAppName : [wstr] キー名を含むセクションの名前。
lpKeyName : [wstr] 値を取得するキーの名前。この値は文字列形式である。GetProfileInt 関数は文字列を整数に変換して返す。
nDefault : [int] 初期化ファイル内でキー名が見つからない場合に返す既定値。

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

解説

Win.ini ファイルの指定セクション内のキーから整数を取得する。(Unicode)

[戻り値]
戻り値は、Win.ini 内の指定キー名に続く文字列の整数等価値。関数がキーを見つけられない場合、戻り値は既定値である。キーの値が 0
未満の場合、戻り値は 0 となる。

[備考]
キー名が数字の後に数値以外の文字が続く場合、関数は数字部分の値のみを返す。たとえば、KeyName=102abc という行に対して関数は
102 を返す。Windows Server 2003 および Windows XP/2000:
プロファイル関数の呼び出しは初期化ファイルではなくレジストリにマップされる場合がある。このマッピングは、初期化ファイルとセクションが以下のレジストリキーの下に指定されている場合に発生する:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows
NT\CurrentVersion\IniFileMapping 処理がマップされている場合、GetProfileInt
関数は初期化ファイルからではなくレジストリから情報を取得する。格納場所の変更は関数の動作に影響を与えない。プロファイル関数は以下の手順で初期化情報を見つける。
(以下省略)

情報

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