次の方法で共有

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 を呼び出します。

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

注釈

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

注意

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

要件

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