SetupGetInfInformationA 関数 (setupapi.h)

[アーティクル]
11/20/2024

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

SetUpGetInfInformation 関数は、指定した INF ファイルの SP_INF_INFORMATION 構造体をバッファーに返します。

構文

WINSETUPAPI BOOL SetupGetInfInformationA(
  [in]      LPCVOID             InfSpec,
  [in]      DWORD               SearchControl,
  [in, out] PSP_INF_INFORMATION ReturnBuffer,
  [in]      DWORD               ReturnBufferSize,
  [in, out] PDWORD              RequiredSize
);

パラメーター

[in] InfSpec

SearchControlの値に応じて、INF ファイルのハンドルまたはファイル名。

[in] SearchControl

このパラメーターには、次のいずれかの定数を指定できます。

INFINFO_INF_SPEC_IS_HINF

InfSpec は INF ハンドルです。 1 つの INF ハンドルは、複数の INF ファイルが一緒に追加読み込まれた場合に参照できます。その場合、この関数によって返される構造体には、複数の情報セットが含まれます。

INFINFO_INF_NAME_IS_ABSOLUTE

InfSpec に指定された文字列は完全なパスです。 InfSpecに対してそれ以上の処理は実行されません。

INFINFO_DEFAULT_SEARCH

InfSpecに指定された INF ファイルの既定の場所を検索します。これはファイル名のみと見なされます。既定の場所は inf%windir%され、その後に system32%windir%が続きます。

INFINFO_REVERSE_DEFAULT_SEARCH

既定の場所が逆の順序で検索される点を除き、INFINFO_DEFAULT_SEARCHと同じです。

INFINFO_INF_PATH_LIST_SEARCH

次の下の DevicePath 値エントリに一覧表示されている各ディレクトリで INF を検索しますHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion

[in, out] ReturnBuffer

NULLしない場合は、この関数が SP_INF_INFORMATION 構造体を返すバッファーを指します。

関数を 1 回呼び出して、必要なバッファーサイズを取得し、必要なメモリを割り当ててから、2 回目に関数を呼び出してデータを取得できます。この手法を使用すると、バッファーサイズが不十分なため、エラーを回避できます。詳細については、このトピックの「解説」セクションを参照してください。

[in] ReturnBufferSize

ReturnBufferのサイズ (バイト単位)。

[in, out] RequiredSize

NULLしない場合は、ReturnBufferが指すバッファーに対して、この関数が必要なサイズ (バイト単位) を返す変数指します。

ReturnBuffer 指定し、必要なサイズが ReturnBufferSizeより大きい場合、関数は失敗し、GetLastError の呼び出しによってERROR_INSUFFICIENT_BUFFERが返されます。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

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

INF ファイルが見つからない場合、関数は FALSE を返し、その後の getLastError 呼び出すとERROR_FILE_NOT_FOUNDが返されます。

備考

この関数が returnBuffer NULL で呼び出され、ReturnBufferSize が 0 (ゼロ) の場合、この関数は、指定されたデータを保持するために必要なバッファーサイズを RequiredSize が指す変数に格納します。関数が成功した場合、戻り値は 0 以外の値になります。それ以外の場合、戻り値は 0 (ゼロ) で、拡張エラー情報は GetLastError呼び出すことによって取得できます。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	setupapi.h
ライブラリ	Setupapi.lib
DLL	Setupapi.dll

次の方法で共有