SetupDiDestroyDriverInfoList-Funktion (setupapi.h)
Die SetupDiDestroyDriverInfoList-Funktion löscht eine Treiberliste.
Syntax
WINSETUPAPI BOOL SetupDiDestroyDriverInfoList(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD DriverType
);
Parameter
[in] DeviceInfoSet
Ein Handle für einen Geräteinformationssatz , der die zu löschende Treiberliste enthält.
[in, optional] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt. Dieser Parameter ist optional und kann auf NULL festgelegt werden. Wenn dieser Parameter angegeben ist, löscht SetupDiDestroyDriverInfoList die Treiberliste für das angegebene Gerät. Wenn dieser Parameter NULL ist, löscht SetupDiDestroyDriverInforInfoList die globale Klassentreiberliste, die DeviceInfoSet zugeordnet ist.
[in] DriverType
Der Typ der zu löschenden Treiberliste, die einer der folgenden Werte sein muss:
SPDIT_CLASSDRIVER
Löschen Sie eine Liste von Klassentreibern. Wenn DeviceInfoDataNULL ist, muss dieser Treiberlistentyp angegeben werden.
SPDIT_COMPATDRIVER
Löschen Sie eine Liste mit kompatiblen Treibern für das angegebene Gerät. DeviceInfoData muss angegeben werden, wenn dieser Treiberlistentyp angegeben wird.
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
Wenn der aktuell ausgewählte Treiber Mitglied der liste ist, die gelöscht wird, wird die Auswahl zurückgesetzt.
Wenn eine Klassentreiberliste gelöscht wird, werden die flags DI_FLAGSEX_DIDINFOLIST und DI_DIDCLASS für den entsprechenden Geräteinformationssatz oder das entsprechende Geräteinformationselement zurückgesetzt. Die DI_MULTMFGS-Flags werden ebenfalls zurückgesetzt.
Wenn eine kompatible Treiberliste zerstört wird, werden die flags DI_FLAGSEX_DIDCOMPATINFO und DI_DIDCOMPAT für das entsprechende Geräteinformationselement zurückgesetzt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |
| APIs | ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393) |