SPFILENOTIFY _ ENDREGISTRATION-Meldung

Wenn Sie die RegisterDlls INF-Direktive verwenden, um DLLs selbst zu registrieren, erhalten Aufrufer von SetupInstallFromInfSection möglicherweise Benachrichtigungen zu jeder Datei, wenn sie registriert oder nicht registriert ist. Um eine SPFILENOTIFY _ ENDREGISTRATION-Benachrichtigung einmal nach dem Registrieren oder Aufheben der Registrierung einer Datei an eine Rückrufroutine zu senden, schließen Sie SPINST _ REGISTERCALLBACKAWARE plus SPINST _ REGSVR in den Flags-Parameter von SetupInstallFromInfSection ein. Um eine Benachrichtigung über die Aufhebung der Registrierung zu senden, schließen Sie SPINST _ REGISTERCALLBACKAWARE plus SPINST _ UNREGSVR in den Flags-Parameter ein.

Die rückrufroutine, die durch den MsgHandler-Parameter von SetupInstallFromInfSection angegeben wird, muss vom Typ PSP _ FILE _ CALLBACK sein. Legen Sie den Context-Parameter auf denselben Kontext fest, der in SetupInstallFromInfSection angegeben ist. Legen Sie den Notification-Parameter auf SPFILENOTIFY _ ENDREGISTRATION fest.

SPFILENOTIFY_ENDREGISTRATION
  Param1 = (UINT_PTR) pointer to file information;
  Param2 = (UINT_PTR) file registration or unregistration;
            

Parameter

Param1

Zeiger auf eine SP _ REGISTER CONTROL _ _ STATUS-Struktur, die Informationen zur registrierten oder nicht registrierten Datei enthält. Der Member cbsize sollte auf die Größe der -Struktur festgelegt werden. FileName sollte auf den vollqualifizierten Pfad der Datei festgelegt werden, die registriert wird. Win32Error sollte auf einen Systemfehlercode festgelegt werden, der einen erweiterten Fehlercode angibt. FailureCode sollte auf einen der gültigen Fehlercodes festgelegt werden, die das Ergebnis der Registrierung angeben. Gültige Fehlercodes finden Sie unter SP _ REGISTER CONTROL _ _ STATUS.

Param2

Wenn die Datei registriert wird, sollte Param2 auf einen Zeiger auf einen Wert ungleich 0 (null) festgelegt werden. Wenn die Registrierung der Datei aufgehoben wird, sollte Param2 auf einen Zeiger auf 0 (null) festgelegt werden.

Rückgabewert

Nach dem Empfang der Benachrichtigung gibt die Rückruffunktion möglicherweise einen der folgenden Werte zurück.

Rückgabecode Beschreibung
FILEOP _ ABORT
Beenden Sie die Verarbeitung des INF-Abschnitts.
FILEOP _ DOIT
Fahren Sie mit der Verarbeitung des Abschnitts INF fort.
FILE _ SKIP
Fortsetzen der Verarbeitung des INF-Abschnitts

Anforderungen

Anforderungen Wert
Unterstützte Mindestversion (Client)
Nur Windows [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Nur Windows Server [ 2003-Desktop-Apps]
Header
Setupapi.h

Weitere Informationen

Übersicht

Benachrichtigungen

SetupInstallFromInfSection

SPFILENOTIFY _ STARTREGISTRATION