SetupDiAskForOEMDisk 函数 (setupapi.h)
SetupDiAskForOEMDisk 函数显示一个对话框,要求用户输入 OEM 安装磁盘的路径。
语法
WINSETUPAPI BOOL SetupDiAskForOEMDisk(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData
);
参数
[in] DeviceInfoSet
为本地计算机 设置的设备信息的 句柄。 此集包含一个设备信息元素,该元素表示正在安装的设备。
[in, optional] DeviceInfoData
指向 SP_DEVINFO_DATA 结构的指针,该结构指定 DeviceInfoSet 中的设备信息元素。 此参数是可选的,可以为 NULL。 如果指定此参数, SetupDiAskForOEMDisk 会将驱动程序与正在安装的设备相关联。 如果此参数为 NULL, 则 SetupDiAskForOEMDisk 会将驱动程序与 DeviceInfoSet 的全局类驱动程序列表相关联。
返回值
如果函数成功,则函数返回 TRUE ,并且更新SP_DEVINSTALLPARAMS结构的 DriverPath 字段以反映新路径。 如果用户取消对话框,则函数返回 FALSE ,对 GetLastError 的调用将返回ERROR_CANCELLED。
注解
SetupDiAskForOEMDisk 允许用户浏览 OEM 安装文件的本地驱动器和网络驱动器。 但是, SetupDiAskForOEMDisk 主要设计为在本地计算机上获取 OEM 驱动程序的路径,然后再选择并安装该计算机上的设备的驱动程序。
虽然如果设备信息设置为远程计算机,则此函数不会失败,但结果是有限的使用,因为设备信息集随后不能用于不支持远程计算机上的操作的 DIF_Xxx 安装请求或 SetupDiXxx 函数。
具体而言,设备信息集不能用作输入,DIF_SELECTDEVICE安装请求为设备选择驱动程序,后跟DIF_INSTALLDEVICE安装请求以在远程计算机上安装设备。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | setupapi.h (包括 Setupapi.h) |
Library | Setupapi.lib |
DLL | Setupapi.dll |