SPFILENOTIFY _ STARTREGISTRATION-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 _ STARTREGISTRATION-Benachrichtigung einmal an die Rückrufroutine zu senden, bevor Sie eine Datei registrieren, 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 _ STARTREGISTRATION fest.

SPFILENOTIFY_STARTREGISTRATION
  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. Das FileName-Mitglied sollte auf den vollqualifizierten Pfad der Datei festgelegt werden, die registriert wird. Win32Error wird nicht verwendet und sollte auf NO ERROR festgelegt _ werden. FailureCode wird nicht verwendet und sollte auf SPREG SUCCESS festgelegt _ werden.

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
Registrieren Oder aufheben Sie die Registrierung der Datei nicht, und beenden Sie die Verarbeitung des INF-Abschnitts.
FILEOP _ DOIT
Registrieren Oder aufheben Sie die Registrierung der Datei, und fahren Sie mit der Verarbeitung des INF-Abschnitts fort.
DATEI _ ÜBERSPRINGEN
Überspringen der Registrierung oder Aufhebung der Registrierung der Datei, aber Fortsetzen der Verarbeitung des INF-Abschnitts

Anforderungen

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

Weitere Informationen

Übersicht

Benachrichtigungen

SetupInstallFromInfSection

SPFILENOTIFY _ ENDREGISTRATION