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 コード ハンドラーの呼び出し」を参照してください。
この関数を呼び出す前に、指定したデバイス情報セットまたは要素に対してドライバーを選択する必要があります。
この関数は、選択した INF ファイル内の CopyFiles、 Delfiles、 Renfiles の各エントリを処理します。
DeviceInfoSet には、ローカル コンピューター上の要素のみが含まれている必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | setupapi.h (Setupapi.h を含む) |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |