Функция SetupDiAskForOEMDisk (setupapi.h)
Функция SetupDiAskForOEMDisk отображает диалоговое окно с запросом у пользователя пути к диску установки изготовителя оборудования.
Синтаксис
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 , если она выполнена успешно, а поле DriverPath структуры SP_DEVINSTALLPARAMS обновляется в соответствии с новым путем. Если пользователь отменяет диалоговое окно, функция возвращает значение FALSE , а вызов GetLastError возвращает ERROR_CANCELLED.
Комментарии
SetupDiAskForOEMDisk позволяет пользователю просматривать локальные и сетевые диски для файлов установки OEM. Однако SetupDiAskForOEMDisk в первую очередь предназначен для получения пути к драйверу OEM на локальном компьютере перед выбором и установкой драйвера для устройства на этом компьютере.
Хотя эта функция не завершится сбоем, если набор сведений об устройстве используется для удаленного компьютера, результатом является ограниченное использование, так как набор сведений об устройстве впоследствии не может использоваться с запросами на установку DIF_Xxx илифункциями SetupDiXxx , которые не поддерживают операции на удаленном компьютере.
В частности, набор сведений об устройстве не может использоваться в качестве входных данных с DIF_SELECTDEVICE запросом на установку, чтобы выбрать драйвер для устройства, а затем DIF_INSTALLDEVICE запрос на установку устройства на удаленном компьютере.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |