SetupDiUnremoveDevice-Funktion (setupapi.h)

  • Artikel

Die SetupDiUnremoveDevice-Funktion ist der Standardhandler für die DIF_UNREMOVE Installationsanforderung.

Syntax

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

Parameter

[in] DeviceInfoSet

Ein Handle für einen Geräteinformationssatz für das lokale System, das ein Geräteinformationselement enthält, das ein Gerät darstellt, das wiederhergestellt und neu gestartet werden soll.

[in, out] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt. Dies ist ein IN-OUT-Parameter, da DeviceInfoData.DevInst wird bei der Rückgabe möglicherweise mit einem neuen Handle-Wert aktualisiert.

Rückgabewert

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

Hinweise

SetupDiUnremoveDevice stellt ein Gerät in einem Hardwareprofil wieder her. Diese Funktion startet das Gerät, wenn möglich, oder sie legt ein Flag in den Geräteinstallationsparametern fest, das schließlich dazu führt, dass der Benutzer aufgefordert wird, das System herunterzufahren.

Hinweis Nur ein Klasseninstallationsprogramm sollte SetupDiUnremoveDevice aufrufen, und zwar nur in den Situationen, in denen das Klasseninstallationsprogramm Vorgänge für geräteunremove ausführen muss, nachdem SetupDiUnremoveDevice den Standardvorgang für die Geräteremove abgeschlossen hat. In solchen Situationen muss das Klasseninstallationsprogramm SetupDiUnremoveDevice direkt aufrufen, wenn das Installationsprogramm eine DIF_UNREMOVE-Anforderung verarbeitet. Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.
 
Das gerät, das wiederhergestellt wird, muss über Klasseninstallationsparameter für DIF_UNREMOVE verfügen, andernfalls schlägt die Funktion fehl, und GetLastError gibt ERROR_NO_CLASSINSTALL_PARAMS zurück.

DeviceInfoSet darf nur Elemente auf dem lokalen Computer enthalten.

Der Aufrufer von SetupDiUnremoveDevice muss Mitglied der Gruppe Administratoren sein.

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

Weitere Informationen

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice