WriteProfileStringW

Win.ini ファイル内の指定セクションに文字列をコピーする。(Unicode)

WriteProfileStringW lpAppName, lpKeyName, lpString

lpAppName : [wstr] 文字列をコピーするセクション。存在しなければ作成される。セクション名は大文字小文字を区別しない。
lpKeyName : [wstr] 文字列に関連付けるキー。指定セクションにキーが存在しなければ作成される。NULL を指定するとセクション内のすべてのエントリを含むセクション全体が削除される。
lpString : [wstr] ファイルに書き込む NULL 終端文字列。NULL を指定すると lpKeyName が指すキーが削除される。

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

解説

Win.ini ファイル内の指定セクションに文字列をコピーする。(Unicode)

[戻り値]
関数が Win.ini への文字列コピーに成功した場合、戻り値は 0 以外。失敗した場合、または Win.ini
のキャッシュ版をフラッシュした場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
Win.ini 内のセクションは key=string
の形式でなければならない。システムは性能向上のため最新のレジストリファイルマッピングのキャッシュを保持する。すべてのパラメータが NULL
なら関数はキャッシュをフラッシュする。システムは大半の .ini ファイル参照を
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\CurrentVersion\IniFileMapping のマッピングでレジストリにマップする。
マップされた場合、WriteProfileString
は初期化ファイルではなくレジストリに書き込むが、関数の動作には影響しない。プロファイル関数は次の手順で初期化情報を見つける。
(以下省略)

情報

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