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
指定 DeviceInfoSet 中裝置介面之SP_DEVICE_INTERFACE_DATA結構的指標。
[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) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |