WriteProfileSectionW

Win.ini ファイル内の指定セクションの内容を、指定したキーと値で置き換える。(Unicode)

WriteProfileSectionW lpAppName, lpString

lpAppName : [wstr] セクションの名前。通常は呼び出し側アプリケーションの名前。
lpString : [wstr] 指定セクションに書き込む新しいキー名と関連付けられた値。65,535 バイトに制限される。Unicode 文字で作成されたファイルなら Unicode 文字を書き込み、それ以外は ANSI 文字でファイルを作成する。

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

解説

Win.ini ファイル内の指定セクションの内容を、指定したキーと値で置き換える。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
lpString バッファ内のキーと値は 1 つ以上の NULL 終端文字列とそれに続く最終 NULL 文字からなる。各文字列は
key=string の形式である。WriteProfileSection
は大文字小文字を区別せず、文字列は大文字小文字の任意の組み合わせでよい。WriteProfileSection
は名前付きセクションの既存キー・値を削除し、lpString
バッファ内のキー名と値を挿入する。本関数は新旧キー名の対応を試みない。本操作はアトミックで、書き込み中に初期化ファイルを読み書きする他の操作は許可されない。システムは性能向上のため最新のレジストリファイルマッピングのキャッシュを保持する。すべてのパラメータが
NULL なら関数はキャッシュをフラッシュする。システムは大半の .ini ファイル参照を
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\CurrentVersion\IniFileMapping のマッピングでレジストリにマップする。
マップされた場合、WriteProfileSection
は初期化ファイルではなくレジストリに書き込むが、関数の動作には影響しない。プロファイル関数は次の手順で初期化情報を見つける。
（以下省略）

情報