SPFILENOTIFY_ENDREGISTRATION message

Article
06/13/2023

Lors de l’utilisation de la directive INF RegisterDlls pour auto-inscrire des DLL, les appelants de SetupInstallFromInfSection peuvent recevoir des notifications sur chaque fichier à mesure qu’il est inscrit ou non inscrit. Pour envoyer une notification SPFILENOTIFY_ENDREGISTRATION à une routine de rappel une fois après l’inscription ou la désinscription d’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_ENDREGISTRATION.

SPFILENOTIFY_ENDREGISTRATION
  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. FileName doit être défini sur le chemin complet du fichier en cours d’inscription. Win32Error doit être défini sur un code d’erreur système indiquant un code d’erreur étendu. FailureCode doit être défini sur l’un des codes d’échec valides indiquant le résultat de l’inscription. Pour obtenir des codes d’échec valides, consultez SP_REGISTER_CONTROL_STATUS.
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

Après avoir reçu une notification, la fonction de rappel peut retourner l’une des valeurs suivantes.

Code de retour	Description
FILEOP_ABORT	Arrêtez le traitement de la section INF.
FILEOP_DOIT	Poursuivez le traitement de la section INF.
FILE_SKIP	Continuer le traitement de 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_STARTREGISTRATION

Partager via