Partager via


SPFILENOTIFY_ENDREGISTRATION message

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