次の方法で共有

SetupEnumInfSectionsA 関数 (setupapi.h)

  • [アーティクル]

[この機能は、[要件] セクションに示されているオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。 代わりに、Windows インストーラーを使用してアプリケーション インストーラーを開発します。 SetupAPI は、デバイス ドライバーのインストールに引き続き使用されます。

SetupEnumInfSections 関数は、INF ファイルからセクション名を取得します。

構文

WINSETUPAPI BOOL SetupEnumInfSectionsA(
  [in]            HINF InfHandle,
  [in]            UINT Index,
  [out, optional] PSTR Buffer,
  [in]            UINT Size,
  [out, optional] UINT *SizeNeeded
);

パラメーター

[in] InfHandle

クエリを実行する INF ファイルへのハンドル。

[in] Index

取得するセクション名の 0 から始まるインデックス。 このインデックスは、INF ファイルに表示されるため、セクションの順序に対応していない可能性があります。

[out, optional] Buffer

セクション名を受け取るバッファーへのポインター。 関数を 1 回呼び出して、必要なバッファー サイズを取得し、必要なメモリを割り当ててから、もう一度関数を呼び出して名前を取得できます。 この手法を使用すると、バッファー サイズが不十分なために発生するエラーを回避できます。 このパラメーターは省略可能です。 詳細については、「解説」セクションを参照してください。

[in] Size

ReturnBuffer 指すバッファーのサイズ (文字単位)。 この数値には、終端 NULL 文字が含まれます。

[out, optional] SizeNeeded

ReturnBufferが指すバッファーの必要なサイズ 受け取る場所へのポインター。 このサイズは、セクション名を格納するために必要な文字数として指定されます(終端 NULL 文字を含む)。

戻り値

関数が成功した場合、戻り値は TRUE。

関数が失敗した場合、戻り値は FALSE。 拡張エラー情報を取得するには、GetLastError呼び出します。

GetLastError は、EnumerationIndex の値が INF ファイル内のセクション名の数以上の場合に ERROR_NO_MORE_ITEMS を返します。

備考

この関数は、INF ファイル内のすべての一意のセクション名を列挙できます。 INF ファイルにセクション名が複数回表示される場合、関数は 1 つの列挙インデックスを使用して 1 回だけ名前を返します。 INF ファイル内のすべてのセクション名を返すには、0 の列挙インデックスで始まる関数を呼び出し、関数が FALSE を返し、GetLastError が ERROR_NO_MORE_ITEMSを返す までインデックス インクリメントしながら、関数を繰り返し呼び出します。 アプリケーションは、列挙インデックスに基づく順序で返されるセクション名に依存しないようにする必要があります。

手記

setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupEnumInfSection を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー setupapi.h
ライブラリ Setupapi.lib
DLL Setupapi.dll
API セットの ext-ms-win-setupapi-inf-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)