SetupDiDeleteDeviceInfo-Funktion (setupapi.h)

  • Artikel

Die SetupDiDeleteDeviceInfo-Funktion löscht ein Geräteinformationselement aus einem Geräteinformationssatz. Diese Funktion löscht das tatsächliche Gerät nicht.

Syntax

WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Ein Handle für den Geräteinformationssatz , der das zu löschende Geräteinformationselement enthält.

[in] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die das zu löschende Geräteinformationselement in DeviceInfoSet darstellt.

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 das angegebene Geräteinformationselement verwendet wird (z. B. durch eine Assistentenseite), schlägt die Funktion fehl. In diesem Fall gibt ein Aufruf von GetLastError ERROR_DEVINFO_DATA_LOCKED zurück. Dies geschieht, wenn ein Handle für eine Assistentenseite mit einem Aufruf von SetupDiGetWizardPage abgerufen wird, wobei dieses Geräteinformationselement angegeben ist und das DIWP_FLAG_USE_DEVINFO_DATA-Flag festgelegt ist. Um dieses Geräteinformationselement zu löschen, müssen Sie zuerst das HPROPSHEETPAGE-Handle des Assistenten schließen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile setupapi.h (einschließlich Setupapi.h)
Bibliothek Setupapi.lib
DLL Setupapi.dll

Weitere Informationen

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo