Share via

SetupDiInstallDriverFiles 関数 (setupapi.h)

  • [アーティクル]

SetupDiInstallDriverFiles 関数は、DIF_INSTALLDEVICEFILESインストール要求の既定のハンドラーです。

構文

WINSETUPAPI BOOL SetupDiInstallDriverFiles(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

パラメーター

[in] DeviceInfoSet

ファイルをインストールする デバイス を表すデバイス情報要素を含むデバイス情報セットのハンドル。 デバイス情報セットにリモート要素を含めてはなりません。

[in] DeviceInfoData

DeviceInfoSet のデバイス情報要素を指定するSP_DEVINFO_DATA構造体へのポインター。

戻り値

成功した場合、この関数は TRUE を 返します。 それ以外の場合は FALSE を 返し、ログに記録されたエラーは GetLastError の呼び出しで取得できます。

注釈

この関数を使用してファイルをインストールする場合、 SetupDiInstallDriverFiles の呼び出し元は Administrators グループのメンバーである必要があります。 ただし、この関数を使用してファイル キューを構築する場合、Administrators グループのメンバーシップは必要ありません。

メモ クラス インストーラーのみが SetupDiInstallDriverFiles を 呼び出す必要があり、 SetupDiInstallDriverFiles が既定のドライバー ファイルのインストール操作を完了した後に、クラス インストーラーがドライバー ファイルのインストール操作を実行する必要がある場合にのみ呼び出す必要があります。 このような状況では、インストーラーがDIF_INSTALLDEVICEFILES要求を処理するときに、クラス インストーラーが SetupDiInstallDriverFiles を直接呼び出す必要があります。 既定のハンドラーの呼び出しの詳細については、「 既定の DIF コード ハンドラーの呼び出し」を参照してください。
 
SetupDiInstallDriverFiles の操作は、SetupDiInstallDevice 関数に似ています。 ただし、この関数は 、SetupDiInstallDevice によって実行されるファイル コピー操作のみを実行します。

この関数を呼び出す前に、指定したデバイス情報セットまたは要素に対してドライバーを選択する必要があります。

この関数は、選択した INF ファイル内の CopyFiles、 Delfiles、 Renfiles の各エントリを処理します。

DeviceInfoSet には、ローカル コンピューター上の要素のみが含まれている必要があります。

要件

要件 値
サポートされている最小のクライアント Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム デスクトップ
Header setupapi.h (Setupapi.h を含む)
Library Setupapi.lib
[DLL] Setupapi.dll

こちらもご覧ください

SetupDiCallClassInstaller

SetupDiInstallDevice