SetupDefaultQueueCallbackA, fonction (setupapi.h)

  • Article

[Cette fonction peut être utilisée 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 installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer les 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 correspondre à l’une des valeurs présentées dans la table ci-dessous.

Valeur Signification
SPFILENOTIFY_STARTQUEUE
 Opérations de fichier mis en file d’attente démarrées.
SPFILENOTIFY_ENDQUEUE
 Opérations de fichier mis en file d’attente terminées.
SPFILENOTIFY_STARTSUBQUEUE
 A 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
 Une opération de renommage a démarré.
SPFILENOTIFY_ENDRENAME
 Opération de renommage terminée.
SPFILENOTIFY_RENAMEERROR
 Une erreur a été rencontrée lors du changement de nom d’un fichier.
SPFILENOTIFY_STARTDELETE
 A démarré 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
 Une opération de copie a démarré.
SPFILENOTIFY_ENDCOPY
 Opération de copie terminée.
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 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 uniquement 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 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. La combinaison 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

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]
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

Vue d'ensemble

SetupCommitFileQueue