SPFILENOTIFY_STARTREGISTRATION message
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 |
|---|---|
|
N’inscrivez pas ou annulez l’inscription du fichier et arrêtez le traitement de la section INF. |
|
Inscrivez ou annulez l’inscription du fichier et poursuivez le traitement de la section INF. |
|
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 |
|