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 |