iniファイルを操作するためのAPI(メモ)

【ご注意】ここに書かれている情報は古い情報となっています。ご利用になる場合は古い情報であるとご認識いただき参考にとどめ、最新の情報はマイクロソフト社の公式の最新情報等をお探しください。

■GetPrivateProfileSectionNames

　指定されたiniファイルの中のセクション( "[" と "]" で囲まれた部分 )を列挙します。

DWORD GetPrivateProfileStruct( LPTSTR lpszReturnBuffer, DWORD nSize, LPCTSTR lpFileName );

●引数

　lpszReturnBuffer … セクション名を受け取るバッファへのポインタを指定します。セクション名とは "[" と "]" で囲まれた部分のことですが、ここでは "[" や "]" は含まれません。各セクション名は \0 (NULL文字) で区切られ、最後は \0\0 (NULL文字2つ) で終わる文字列が返されます。
　nSize … lpszReturnBufferの大きさを指定します。
　lpFileName … iniファイル名を指定します。パスが指定されなかった場合は、Windowsフォルダが指定されたものと見なします。カレントフォルダを指定したい場合は、ファイル名の前に .\ を付けると良いでしょう。NULLが指定されると、Win.iniが指定されたものとみなします。

●戻り値

　lpszReturnBufferに代入されたバイト数が返されます。
　バッファのサイズが不足して、すべてのセクションを返しきれなかった場合は、nSize-2 が返されます。プログラムはこの値を受け取ったら、バッファのサイズを適当に増やして再度読み込みを試行することを繰り返すことで、任意の長さの文字列を取得することができます。

●注意

　この関数は過去のWindowsとの互換を保つために残されています。Win32プログラムでは、設定は大きすぎない限り、レジストリに格納することが奨められています。
　Windows 95では、セクションのサイズは32KB(32767文字)に制限されます。

　戻る

※このページは、ソフトウェアに付属のヘルプファイルをWeb用に再構築したものです。大部分に自動変換を施しているため、一部は正しく変換しきれずに表示の乱れている箇所があるかもしれませんが、ご容赦下さい。また、本ドキュメントはアーカイブドキュメントであり、内容は「いじくるつくーる」最終公開時点、あるいは、それより古い時点のものとなっております。一部、内容が古くなっている箇所があるかと思いますが、あらかじめご了承下さい。
※このページへは、自由にリンクしていただいてかまいません。
このページに関するご意見の受け付けは終了しています。

/トップ/いじくるつくーる/ダウンロード/WebHelp/ヘルプトップ/