messaggio SPFILENOTIFY_ENDREGISTRATION

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