Fonction SetupInitDefaultQueueCallbackEx (setupapi.h)
[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) |