SPFILENOTIFY_STARTREGISTRATION messaggio

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 la registrazione. Per inviare una notifica di SPFILENOTIFY_STARTREGISTRATION alla routine di callback una volta prima di registrare 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 Notifica su SPFILENOTIFY_STARTREGISTRATION.

SPFILENOTIFY_STARTREGISTRATION
  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. Il membro FileName deve essere impostato sul percorso completo del file registrato. Win32Error non viene usato e deve essere impostato su NO_ERROR. FailureCode non viene usato e deve essere impostato su SPREG_SUCCESS.

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
Non registrare o annullare la registrazione del file e interrompere l'elaborazione della sezione INF.
FILEOP_DOIT
Registrare o annullare la registrazione del file e continuare a elaborare la sezione INF.
FILE_SKIP
Ignorare la registrazione o annullare la registrazione del file, ma 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_ENDREGISTRATION