SPFILENOTIFY_STARTREGISTRATION 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 vor der Registrierung einer Datei eine SPFILENOTIFY_STARTREGISTRATION Benachrichtigung an die 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_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 über die Datei enthält, die registriert oder nicht registriert wird. Das Element cbsize sollte auf die Größe der Struktur festgelegt werden. Das FileName-Element sollte auf den vollqualifizierten Pfad der zu registrierenden Datei festgelegt werden. 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 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 |
|---|---|
|
Registrieren oder aufheben Sie die Registrierung der Datei nicht, und beenden Sie die Verarbeitung des INF-Abschnitts. |
|
Registrieren oder aufheben Sie die Registrierung der Datei, und fahren Sie mit der Verarbeitung des INF-Abschnitts fort. |
|
Die Registrierung oder Aufhebung der Registrierung der Datei überspringen, aber die Verarbeitung des INF-Abschnitts fortsetzen |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|