messaggio SPFILENOTIFY_ENDREGISTRATION

Articolo
06/13/2023

Quando si usa la direttiva REGISTERDlls INF per registrare automaticamente le DLL, i chiamanti di SetupInstallFromInfSection possono ricevere notifiche su ogni file durante la registrazione o l'annullamento della registrazione. Per inviare una notifica di SPFILENOTIFY_ENDREGISTRATION a una routine di callback una volta dopo la registrazione o l'annullamento della registrazione di un file, includere SPINST_REGISTERCALLBACKAWARE più SPINST_REGSVR nel parametro Flags di SetupInstallFromInfSection. Per inviare una notifica di annullamento della registrazione, includere SPINST_REGISTERCALLBACKAWARE più SPINST_UNREGSVR nel parametro Flags .

La routine di callback specificata dal parametro MsgHandler di SetupInstallFromInfSection deve essere il tipo PSP_FILE_CALLBACK. Impostare il parametro Context sullo stesso contesto specificato in SetupInstallFromInfSection. Impostare il parametro Notificationsu SPFILENOTIFY_ENDREGISTRATION.

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

Parametri

Param1: Puntatore a una struttura SP_REGISTER_CONTROL_STATUS contenente informazioni sul file registrato o non registrato. Il membro cbsize deve essere impostato sulle dimensioni della struttura. FileName deve essere impostato sul percorso completo del file registrato. Win32Error deve essere impostato su un codice di errore di sistema che indica un codice di errore esteso. FailureCode deve essere impostato su uno dei codici di errore validi che indicano il risultato della registrazione. Per i codici di errore validi, vedere SP_REGISTER_CONTROL_STATUS.
Param2: Se il file viene registrato, Param2 deve essere impostato su un puntatore a un valore diverso da zero. Se il file viene annullato, Param2 deve essere impostato su un puntatore a zero.

Valore restituito

Dopo la ricezione della notifica, la funzione di callback può restituire uno dei valori seguenti.

Codice restituito	Descrizione
FILEOP_ABORT	Interrompere l'elaborazione della sezione INF.
FILEOP_DOIT	Continuare a elaborare la sezione INF.
FILE_SKIP	Continuare a elaborare la sezione INF

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Setupapi.h

Vedi anche

Panoramica
Notifications
SetupInstallFromInfSection
SPFILENOTIFY_STARTREGISTRATION

Condividi tramite