Fonction SetupInitDefaultQueueCallbackEx (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 SetupInitDefaultQueueCallbackEx initialise le contexte utilisé par la routine de rappel de file d’attente par défaut incluse avec l’API Setup de la même manière que SetupInitDefaultQueueCallback, sauf qu’une fenêtre supplémentaire est fournie à la fonction de rappel pour accepter les messages de progression.

Syntaxe

WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
  [in] HWND  OwnerWindow,
  [in] HWND  AlternateProgressWindow,
  [in] UINT  ProgressMessage,
  [in] DWORD Reserved1,
  [in] PVOID Reserved2
);

Paramètres

[in] OwnerWindow

Handle vers la fenêtre à utiliser comme parent de toutes les boîtes de dialogue générées par la routine de rappel par défaut.

[in] AlternateProgressWindow

Gérez vers une fenêtre qui reçoit les messages de progression. Pour empêcher l’affichage des messages de progression, vous pouvez spécifier ce paramètre à INVALID_HANDLE_VALUE.

[in] ProgressMessage

Message envoyé à AlternateProgressWindow lorsque la file d’attente de copie est démarrée et chaque fois qu’un fichier est copié.

[in] Reserved1

Premier paramètre de message envoyé à AlternateProgressWindow par la routine de rappel par défaut.

[in] Reserved2

Deuxième paramètre de message envoyé à AlternateProgressWindow par la routine de rappel par défaut.

Valeur retournée

SetupInitDefaultQueueCallbackEx retourne un pointeur vers le contexte utilisé par la routine de rappel de file d’attente par défaut. Cette fonction ne peut échouer qu’en cas de mémoire insuffisante. Si cette fonction échoue, elle retourne NULL et ne définit pas le code de dernière erreur pour le thread.

Remarques

Lorsque la file d’attente commence à valider la sous-file d’attente de copie, la routine de rappel de file d’attente par défaut envoie un message à la fenêtre spécifiée dans AlternateProgressWindow. Reserved1 a la valeur 0, et Reserved2 contient un pointeur vers le nombre d’opérations de copie de fichiers en file d’attente.

Pour chaque opération de copie de fichier terminée, la routine de rappel de file d’attente par défaut envoie un message à AlternateProgressWindow, qui peut être utilisé pour « cocher » la barre de progression. Reserved1 a la valeur 1 et Reserved2 est zéro.

SetupInitDefaultQueueCallbackEx peut être utilisé pour obtenir le comportement par défaut pour l’invite de disque, la gestion des erreurs, etc., et fournir une jauge incorporée dans une page d’Assistant ou une autre boîte de dialogue spécialisée.

Que vous initialisiez le contexte utilisé par la routine de rappel de file d’attente par défaut avec SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx, une fois le traitement des opérations en file d’attente terminé, appelez SetupTermDefaultQueueCallback pour libérer les ressources allouées à l’initialisation de la structure de contexte. Pour plus d’informations, consultez Initialisation et fin du contexte de rappel.

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

SetupInitDefaultQueueCallback