GetPrivateProfileSectionNamesW

GetPrivateProfileSectionNamesW (Unicode) 関数 (winbase.h) は、初期化ファイル内のすべてのセクション名を取得する。

GetPrivateProfileSectionNamesW lpszReturnBuffer, nSize, lpFileName

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

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

解説

GetPrivateProfileSectionNamesW (Unicode) 関数 (winbase.h)
は、初期化ファイル内のすべてのセクション名を取得する。

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

[備考]
この処理はアトミックである。セクション名がバッファにコピーされている間、初期化ファイルへの更新は許可されない。システムはほとんどの
.ini ファイル参照を、以下のレジストリキーの下で定義されたマッピングを使用してレジストリにマップする:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\CurrentVersion\IniFileMapping
このマッピングは、Control.ini、System.ini、Winfile.ini
などのシステムコンポーネント初期化ファイルをアプリケーションが変更する場合に発生する可能性が高い。これらの場合、関数は初期化ファイルからではなくレジストリから情報を取得する。格納場所の変更は関数の動作に影響を与えない。プロファイル関数は以下の手順で初期化情報を見つける。
（以下省略）

情報