共用方式為


SetupDiAskForOEMDisk 函式 (setupapi.h)

SetupDiAskFor OEMDisk 函式會顯示對話框,詢問使用者 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。

備註

SetupDiAskFor OEMDisk 可讓使用者流覽 OEM 安裝檔案的本機和網路磁碟驅動器。 不過, SetupDiAskFor OEMDisk 主要設計為先取得本機電腦上的 OEM 驅動程式路徑,再選取並安裝該電腦上的裝置驅動程式。

雖然如果針對遠端電腦設定了裝置資訊,則此函式不會失敗,但結果會受到限制,因為裝置資訊集後續無法搭配 DIF_Xxx 安裝要求使用,或不支援遠端電腦上的 作業的 SetupDiXxx 函式。

特別是,裝置資訊集不能當做輸入與DIF_SELECTDEVICE安裝要求搭配使用,以選取裝置的驅動程式,後面接著DIF_INSTALLDEVICE安裝要求,在遠端電腦上安裝裝置。

規格需求

需求
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 setupapi.h (包括 Setupapi.h)
程式庫 Setupapi.lib
Dll Setupapi.dll

另請參閱

SetupDiSelectOEMDrv