GetPrivateProfileSectionW

GetPrivateProfileSectionW (Unicode) 関数 (winbase.h) は、初期化ファイルの指定セクションのすべてのキーと値を取得する。

GetPrivateProfileSectionW lpAppName, lpReturnedString, nSize, lpFileName

lpAppName : [wstr] 初期化ファイル内のセクション名。
lpReturnedString : [wstr] 指定したセクションに関連するキー名と値のペアを受け取るバッファへのポインタ。バッファは 1 つ以上の null 終端文字列で埋められ、最後の文字列の後にはさらに null 文字が続く。
nSize : [int] lpReturnedString パラメータが指すバッファのサイズ（文字数）。
lpFileName : [wstr] 初期化ファイルの名前。このパラメータがファイルへのフルパスを含まない場合、システムは Windows ディレクトリ内でファイルを検索する。

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

解説

GetPrivateProfileSectionW (Unicode) 関数 (winbase.h)
は、初期化ファイルの指定セクションのすべてのキーと値を取得する。

[戻り値]
戻り値は、バッファにコピーされた文字数（終端 null
文字を除く）。バッファが指定したセクションに関連するすべてのキー名と値のペアを含むのに十分な大きさでない場合、戻り値は nSize から
2 を引いた値に等しい。

[備考]
lpReturnedString パラメータが指すバッファ内のデータは、1 つ以上の null 終端文字列で構成され、最後に null
文字が続く。各文字列は次の形式である: key=string GetPrivateProfileSection
関数は大文字と小文字を区別しない。lpAppName
パラメータが指す文字列は大文字と小文字の組み合わせでよい。この処理はアトミックである。セクションのキー名と値のペアが
lpReturnedString
パラメータが指すバッファにコピーされている間、指定した初期化ファイルへの更新は許可されない。システムはほとんどの .ini
ファイル参照を、以下のレジストリキーの下で定義されたマッピングを使用してレジストリにマップする:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\CurrentVersion\IniFileMapping
このマッピングは、Control.ini、System.ini、Winfile.ini
などのシステムコンポーネント初期化ファイルをアプリケーションが変更する場合に発生する可能性が高い。これらの場合、関数は初期化ファイルからではなくレジストリから情報を取得する。格納場所の変更は関数の動作に影響を与えない。プロファイル関数は以下の手順で初期化情報を見つける。
（以下省略）

情報