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

另請參閱

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail