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

另请参阅

SetupDiSelectOEMDrv