SetupDiAskForOEMDisk 関数 (setupapi.h)

  • [アーティクル]

SetupDiAskForOEMDisk 関数は、OEM インストール ディスクのパスをユーザーに求めるダイアログを表示します。

構文

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

パラメーター

[in] DeviceInfoSet

ローカル コンピューターの デバイス情報セット へのハンドル。 このセットには、インストールされているデバイスを表すデバイス情報要素が含まれています。

[in, optional] DeviceInfoData

DeviceInfoSet のデバイス情報要素を指定するSP_DEVINFO_DATA構造体へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。 このパラメーターを指定すると、 SetupDiAskForOEMDisk によってドライバーがインストールされているデバイスに関連付けられます。 このパラメーターが NULL の場合、 SetupDiAskForOEMDisk は ドライバーを DeviceInfoSet のグローバル クラス ドライバー リストに関連付けます。

戻り値

関数が成功し、新しいパスを反映するようにSP_DEVINSTALLPARAMS構造体の DriverPath フィールドが更新された場合、この関数は TRUE を返します。 ユーザーがダイアログをキャンセルすると、関数は FALSE を 返し、 GetLastError の呼び出しはERROR_CANCELLEDを返します。

注釈

SetupDiAskForOEMDisk を使用すると、ユーザーは OEM インストール ファイルのローカル ドライブとネットワーク ドライブを参照できます。 ただし、 SetupDiAskForOEMDisk は、主にそのコンピューター上のデバイスのドライバーを選択してインストールする前に、ローカル コンピューター上の OEM ドライバーのパスを取得するように設計されています。

リモート コンピューターに対してデバイス情報が設定されている場合、この関数は失敗しませんが、その後、デバイス情報セットは、リモート コンピューターでの操作をサポートしない DIF_Xxx インストール要求または SetupDiXxx 関数で使用できないため、使用が制限されます。

特に、デバイス情報セットは、デバイスのドライバーを選択するためのDIF_SELECTDEVICEインストール要求と共に入力として使用することはできません。その後、リモート コンピューターにデバイスをインストールするためのDIF_INSTALLDEVICEインストール要求が続きます。

要件

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

こちらもご覧ください

SetupDiSelectOEMDrv