InstallNewDevice-Funktion

Installiert ein neues Gerät. Der Benutzer wird aufgefordert, das Gerät auszuwählen.

Syntax

BOOL WINAPI InstallNewDevice(
  _In_  HWND   hwndParent,
  _In_  LPGUID ClassGuid,
  _Out_ PDWORD pReboot
);

Parameter

hwndParent [ In]

Ein Handle für das Fenster der obersten Ebene, das für alle erforderlichen Benutzeroberflächen verwendet werden soll.

ClassGuid [ In]

Ein Zeiger auf eine Klassen-GUID. Dieser Parameter ist optional. Wenn dieser Parameter NULL ist, beginnt der Benutzer auf der Erkennungsauswahlseite. Wenn dieser Parameter GUID _ NULL oder GUID _ DEVCLASS _ UNKNOWN ist, beginnt der Benutzer auf der Seite zur Klassenauswahl.

pReboot [ out]

Ein Zeiger auf eine Variable, die den Neustartstatus empfängt. Dieser Parameter kann DI _ NEEDRESTART oder DI _ NEEDREBOOT sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Bemerkungen

Dieser Funktion ist keine Importbibliothek zugeordnet. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit NewDev.dll zu verknüpfen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP
Unterstützte Mindestversion (Server)
Windows Server 2003
DLL
NewDev.dll

Weitere Informationen

Geräteverwaltung Functions