共用方式為


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