SetupDiSetDeviceInterfaceDefault-Funktion (setupapi.h)

Die SetupDiSetDeviceInterfaceDefault-Funktion legt eine Geräteschnittstelle als Standardschnittstelle für eine Geräteschnittstellenklasse fest.

Syntax

WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [in]      DWORD                     Flags,
            PVOID                     Reserved
);

Parameter

[in] DeviceInfoSet

Ein Handle für den Geräteinformationssatz , der die Geräteschnittstelle enthält, die als Standard für eine Geräteschnittstellenklasse festgelegt werden soll.

[in, out] DeviceInterfaceData

Ein Zeiger auf eine SP_DEVICE_INTERFACE_DATA Struktur, die die Geräteschnittstelle in DeviceInfoSet angibt.

[in] Flags

Nicht verwendet, muss null sein.

Reserved

Für die zukünftige Verwendung reserviert, muss NULL sein.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.

Hinweise

Ein Aufrufer muss über Administratorrechte verfügen, um die Standardschnittstelle für eine Geräteschnittstellenklasse festzulegen. Wenn die angeforderte Standardschnittstelle jedoch mit der aktuell festgelegten Standardschnittstelle identisch ist, gibt die Funktion TRUE zurück, unabhängig davon, ob der Aufrufer über Administratorrechte verfügt.

Wenn die Funktion die angegebene Geräteschnittstelle erfolgreich als Standard für die Geräteklasse festlegt, aktualisiert sie den Flags-Member der angegebenen SP_DEVICE_INTERFACE_DATA-Struktur.

Rufen Sie SetupDiGetClassDevs auf, um ein DevInfoSet-Handle für einen Geräteinformationssatz abzurufen, der die Geräteschnittstelle enthält, die als Standard für eine Geräteschnittstellenklasse festgelegt werden soll. Um den DeviceInterfaceData-Zeiger auf das Geräteschnittstellenelement abzurufen, rufen Sie SetupDiEnumDeviceInterfaces auf, um die Schnittstellen im Geräteinformationssatz aufzulisten. Um Informationen zu einer enumerierten Schnittstelle abzurufen, rufen Sie SetupDiGetDeviceInterfaceDetail auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek	Setupapi.lib
DLL	Setupapi.dll

Weitere Informationen

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail