Fonction SetupDefaultQueueCallbackW (setupapi.h)

Article
08/26/2023

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des pilotes de périphérique.]

La fonction SetupDefaultQueueCallback est la routine de rappel de file d’attente par défaut incluse avec l’API d’installation. Vous pouvez l’utiliser pour traiter les notifications envoyées par la fonction SetupCommitFileQueue .

Syntaxe

WINSETUPAPI UINT SetupDefaultQueueCallbackW(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

Paramètres

[in] Context

Pointeur vers le contexte initialisé par les fonctions SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx .

[in] Notification

Notification d’une action de file d’attente. Ce paramètre peut correspondre à l’une des valeurs présentées dans la table ci-dessous.

Valeur	Signification
SPFILENOTIFY_STARTQUEUE	Les opérations de fichier mis en file d’attente ont démarré.
SPFILENOTIFY_ENDQUEUE	Opérations de fichier mis en file d’attente terminées.
SPFILENOTIFY_STARTSUBQUEUE	Démarré une sous-file d’attente de copie, de renommage ou de suppression.
SPFILENOTIFY_ENDSUBQUEUE	Fin d’une sous-file d’attente de copie, de renommage ou de suppression.
SPFILENOTIFY_STARTRENAME	A démarré une opération de renommage.
SPFILENOTIFY_ENDRENAME	Fin d’une opération de renommage.
SPFILENOTIFY_RENAMEERROR	Une erreur s’est produite lors du changement de nom d’un fichier.
SPFILENOTIFY_STARTDELETE	Démarrage d’une opération de suppression.
SPFILENOTIFY_ENDDELETE	Opération de suppression terminée.
SPFILENOTIFY_DELETEERROR	Une erreur a été rencontrée lors de la suppression d’un fichier.
SPFILENOTIFY_STARTCOPY	Démarrage d’une opération de copie.
SPFILENOTIFY_ENDCOPY	Opération de copie terminée.
SPFILENOTIFY_COPYERROR	Une erreur a été rencontrée lors de la copie d’un fichier.
SPFILENOTIFY_NEEDMEDIA	Un nouveau média est requis.
SPFILENOTIFY_LANGMISMATCH	Le fichier cible existant est dans une langue différente de celle de la source.
SPFILENOTIFY_TARGETEXISTS	Le fichier cible existe.
SPFILENOTIFY_TARGETNEWER	Le fichier cible existant est plus récent que la source.

[in] Param1

Informations supplémentaires sur les messages. Le contenu de ce paramètre dépend de la valeur du paramètre Notification .

[in] Param2

Informations supplémentaires sur les messages. Le contenu de ce paramètre dépend de la valeur du paramètre Notification .

Valeur retournée

Retourne un entier non signé à SetupCommitFileQueue qui peut être l’une des valeurs indiquées dans le tableau suivant.

Code de retour	Description
FILEOP_ABORT	Abandonne l'opération.
FILEOP_DOIT	Effectue l’opération de fichier.
FILEOP_SKIP	Ignore l’opération.
FILEOP_RETRY	Réessayez l’opération.
FILEOP_NEWPATH	Obtient un nouveau chemin d’accès pour l’opération.

Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction SetupDefaultQueueCallback est généralement appelée explicitement par une routine de rappel de file d’attente personnalisée. Le rappel personnalisé gère un sous-ensemble des notifications de validation de file d’attente et appelle la fonction SetupDefaultQueueCallback pour gérer le reste des notifications.

Pour plus d’informations, consultez Notifications de file d’attente.

Notes

L’en-tête setupapi.h définit SetupDefaultQueueCallback comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	setupapi.h
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll
Ensemble d’API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Fonctions

Présentation

SetupCommitFileQueue

Partager via