Функция SetupDiSetDeviceInterfaceDefault (setupapi.h)
Функция SetupDiSetDeviceInterfaceDefault задает интерфейс устройства в качестве интерфейса по умолчанию для класса интерфейса устройства.
Синтаксис
WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
[in] DWORD Flags,
PVOID Reserved
);
Параметры
[in] DeviceInfoSet
Дескриптор набора сведений об устройстве , который содержит интерфейс устройства, заданный по умолчанию для класса интерфейса устройства.
[in, out] DeviceInterfaceData
Указатель на структуру SP_DEVICE_INTERFACE_DATA , указывающую интерфейс устройства в DeviceInfoSet.
[in] Flags
Не используется, должно быть равно нулю.
Reserved
Зарезервировано для использования в будущем, должно иметь значение NULL.
Возвращаемое значение
Функция возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.
Комментарии
Вызывающий объект должен иметь права администратора, чтобы задать интерфейс по умолчанию для класса интерфейса устройства. Однако если запрошенный интерфейс по умолчанию совпадает с текущим заданным интерфейсом по умолчанию, функция возвращает значение TRUE независимо от того, имеет ли вызывающий объект права администратора.
Если функция успешно задает указанный интерфейс устройства в качестве используемого по умолчанию для класса устройства, она обновляет элемент Flags предоставленной структуры SP_DEVICE_INTERFACE_DATA.
Вызовите SetupDiGetClassDevs , чтобы получить дескриптор DevInfoSet для набора сведений об устройстве, который содержит интерфейс устройства, заданный по умолчанию для класса интерфейса устройства. Чтобы получить указатель DeviceInterfaceData на элемент интерфейса устройства, вызовите SetupDiEnumDeviceInterfaces для перечисления интерфейсов в наборе сведений об устройстве. Чтобы получить сведения о перечислимом интерфейсе, вызовите SetupDiGetDeviceInterfaceDetail.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows XP и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |