SetupDiRegisterCoDeviceInstallers 関数 (setupapi.h)

  • [アーティクル]

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 コード ハンドラーの呼び出し」を参照してください。
 
SetupDiRegisterCoDeviceInstallers は 、 DeviceInfoData で指定されたデバイスの INF ファイルを読み取り、INF ファイルに一覧表示されているデバイス固有の共同インストーラーを登録するためのレジストリ エントリを作成します。 共同インストーラーは、 INF DDInstall.CoInstallers セクションに記載されています。 この関数は、DI_NOFILECOPY フラグが設定されていない限り、共同インストーラーのファイルもコピーします。

ドライバーが選択されていない場合、またはデバイスに Windows 9x または Millennium Edition 用の INF ファイルがある場合、この関数は共同インストーラーを登録しません。

新しいデバイス固有の共同インストーラーを登録すると、デバイス インストーラーの現在の共同インストーラーの一覧が無効になります。 登録が成功すると、デバイス インストーラーによって共同インストーラーの一覧が更新されます。

この関数は、クラスの共同インストーラーではなく、デバイス固有の共同インストーラーのみを登録します。

デバイス固有の共同インストーラーを作成および登録する方法の詳細については、「 共同インストーラーの作成」を参照してください。

DeviceInfoSet で指定されたデバイス情報セットには、ローカル コンピューター上の要素のみが含まれている必要があります。

要件

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

こちらもご覧ください

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller