SetupDiRegisterCoDeviceInstallers 関数は、DIF_REGISTER_COINSTALLERSの既定のハンドラーです。
構文
WINSETUPAPI BOOL SetupDiRegisterCoDeviceInstallers(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
パラメーター
[in] DeviceInfoSet
共同インストーラーを登録するデバイスを表すデバイス情報要素を含むデバイス情報 セット のハンドル。 デバイス情報セットには、リモート要素を含めてはなりません。
[in] DeviceInfoData
DeviceInfoSet のデバイス情報要素を指定するSP_DEVINFO_DATA構造体へのポインター。
戻り値
関数が成功した場合、SetupDiRegisterCoDeviceInstallers はTRUE を返します。 関数が FALSE を返す場合は、拡張エラー情報に 対して GetLastError を呼び出します。
注釈
SetupDiRegisterCoDeviceInstallers の呼び出し元は、Administrators グループのメンバーである必要があります。
メモ クラス インストーラーのみが SetupDiRegisterCoDeviceInstallers を 呼び出す必要があり、 SetupDiRegisterCoDeviceInstallers が既定の共同インストーラー登録操作を完了した後に、クラス インストーラーが共同インストーラー登録操作を実行する必要がある場合にのみ呼び出す必要があります。 このような状況では、インストーラーがDIF_REGISTER_COINSTALLERS要求を処理するときに、クラス インストーラーが SetupDiRegisterCoDeviceInstallers を直接呼び出す必要があります。 既定のハンドラーの呼び出しの詳細については、「 既定の DIF コード ハンドラーの呼び出し」を参照してください。
ドライバーが選択されていない場合、またはデバイスに Windows 9x または Millennium Edition 用の INF ファイルがある場合、この関数は共同インストーラーを登録しません。
新しいデバイス固有の共同インストーラーを登録すると、デバイス インストーラーの現在の共同インストーラーの一覧が無効になります。 登録が成功すると、デバイス インストーラーによって共同インストーラーの一覧が更新されます。
この関数は、クラスの共同インストーラーではなく、デバイス固有の共同インストーラーのみを登録します。
デバイス固有の共同インストーラーを作成および登録する方法の詳細については、「 共同インストーラーの作成」を参照してください。
DeviceInfoSet で指定されたデバイス情報セットには、ローカル コンピューター上の要素のみが含まれている必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | setupapi.h (Setupapi.h を含む) |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |