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 jede erforderliche Benutzeroberfläche 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 Klassenauswahlseite.

pReboot [out]

Ein Zeiger auf eine Variable, die den Neustart status 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

Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit NewDev.dll zu verknüpfen.

Anforderungen

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

Siehe auch

Geräteverwaltung-Funktionen