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 。
如果函数成功将指定的设备接口设置为设备类的默认接口，则会更新提供的 SP_DEVICE_INTERFACE_DATA 结构的 Flags 成员。
调用 SetupDiGetClassDevs 以获取设备信息集的 DevInfoSet 句柄，该设备信息集包含要设置为设备接口类的默认接口的设备接口。 若要获取指向设备接口元素的 DeviceInterfaceData 指针，请调用 SetupDiEnumDeviceInterfaces 以枚举设备信息集中的接口。 若要检索有关枚举接口的信息，请调用 SetupDiGetDeviceInterfaceDetail。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows XP 和更高版本的 Windows 中可用。 |
| 目标平台 | 桌面 |
| 标头 | setupapi.h (包括 Setupapi.h) |
| Library | Setupapi.lib |
| DLL | Setupapi.dll |