SPFILENOTIFY_STARTREGISTRATION message

Article
06/13/2023

Lors de l’utilisation de la directive INF RegisterDlls pour inscrire automatiquement des DLL, les appelants de SetupInstallFromInfSection peuvent recevoir des notifications sur chaque fichier, car il est inscrit ou non inscrit. Pour envoyer une notification de SPFILENOTIFY_STARTREGISTRATION à la routine de rappel une fois avant d’inscrire un fichier, incluez SPINST_REGISTERCALLBACKAWARE plus SPINST_REGSVR dans le paramètre Flags de SetupInstallFromInfSection. Pour envoyer une notification de désinscription, incluez SPINST_REGISTERCALLBACKAWARE plus SPINST_UNREGSVR dans le paramètre Flags .

La routine de rappel spécifiée par le paramètre MsgHandler de SetupInstallFromInfSection doit être de type PSP_FILE_CALLBACK. Définissez le paramètre Context sur le contexte spécifié dans SetupInstallFromInfSection. Définissez le paramètre Notification sur SPFILENOTIFY_STARTREGISTRATION.

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

Paramètres

Param1: Pointeur vers une structure de SP_REGISTER_CONTROL_STATUS contenant des informations sur le fichier en cours d’inscription ou de désinscription. Le membre cbsize doit être défini sur la taille de la structure. Le membre FileName doit être défini sur le chemin complet du fichier en cours d’inscription. Win32Error n’est pas utilisé et doit être défini sur NO_ERROR. FailureCode n’est pas utilisé et doit être défini sur SPREG_SUCCESS.
Param2: Si le fichier est inscrit, Param2 doit être défini sur un pointeur vers une valeur différente de zéro. Si le fichier est en cours de désinscription, Param2 doit être défini sur un pointeur sur zéro.

Valeur retournée

Une fois la notification reçue, la fonction de rappel peut retourner l’une des valeurs suivantes.

Code de retour	Description
FILEOP_ABORT	N’inscrivez pas ou annulez l’inscription du fichier et arrêtez le traitement de la section INF.
FILEOP_DOIT	Inscrivez ou annulez l’inscription du fichier et poursuivez le traitement de la section INF.
FILE_SKIP	Ignorer l’inscription ou la désinscription du fichier, mais continuer à traiter la section INF

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Setupapi.h

Voir aussi

Présentation
Notifications
SetupInstallFromInfSection
SPFILENOTIFY_ENDREGISTRATION

Partager via