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 |