SetupDefaultQueueCallbackA, fonction (setupapi.h)

Article
11/20/2024

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer 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 SetupDefaultQueueCallbackA(
  [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 être l’une des valeurs indiquées dans le tableau suivant.

Valeur	Signification
SPFILENOTIFY_STARTQUEUE	Démarrage des opérations de fichier en file d’attente.
SPFILENOTIFY_ENDQUEUE	Opérations de fichier en file d’attente terminées.
SPFILENOTIFY_STARTSUBQUEUE	Démarrage d’une copie, d’un renommage ou d’une sous-file d’attente.
SPFILENOTIFY_ENDSUBQUEUE	Fin d’une copie, d’un renommage ou d’une sous-file d’attente.
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	Fin d’une opération de suppression.
SPFILENOTIFY_DELETEERROR	Une erreur s’est produite lors de la suppression d’un fichier.
SPFILENOTIFY_STARTCOPY	A démarré une opération de copie.
SPFILENOTIFY_ENDCOPY	Fin d’une opération de copie.
SPFILENOTIFY_COPYERROR	Une erreur s’est produite 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 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 de retour

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

Retourner le code	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’erreur étendues, 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.

Note

L’en-tête setupapi.h définit SetupDefaultQueueCallback comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’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

Functions

Vue d’ensemble

SetupCommitFileQueue

Partager via