SPFILENOTIFY_ENDREGISTRATION Nachricht

Wenn Sie die RegisterDlls INF-Direktive verwenden, um DLLs selbst zu registrieren, erhalten Aufrufer von SetupInstallFromInfSection möglicherweise Benachrichtigungen für jede Datei, wenn sie registriert oder nicht registriert ist. Um nach dem Registrieren oder Aufheben der Registrierung einer Datei eine SPFILENOTIFY_ENDREGISTRATION Benachrichtigung an eine Rückrufroutine zu senden, fügen 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 vom MsgHandler-Parameter von SetupInstallFromInfSection angegebene Rückrufroutine muss der 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 über die Datei enthält, die registriert oder nicht registriert wird. Das Element cbsize sollte auf die Größe der Struktur festgelegt werden. FileName sollte auf den vollqualifizierten Pfad der zu registrierenden Datei festgelegt werden. 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 null festgelegt werden. Wenn die Registrierung der Datei aufgehoben wird, sollte Param2 auf einen Zeiger auf 0 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 INF-Abschnitts fort.
FILE_SKIP
Weiterverarbeitung des INF-Abschnitts

Anforderungen

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

Weitere Informationen

Übersicht

Benachrichtigungen

SetupInstallFromInfSection

SPFILENOTIFY_STARTREGISTRATION