SPFILENOTIFY_STARTREGISTRATION messaggio

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 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

Condividi tramite