Функция 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

См. также раздел

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail