Initialisation et fin du contexte de rappel

Avant que la routine de rappel de file d’attente par défaut puisse être utilisée, soit en la spécifiant comme routine de rappel lors de la validation d’une file d’attente de fichiers, soit en l’appelant à partir d’une routine de rappel personnalisée, elle doit être initialisée.

La fonction SetupInitDefaultQueueCallback génère la structure de contexte utilisée par la routine de rappel de file d’attente par défaut. Il retourne un pointeur void vers cette structure. Cette structure est essentielle pour l’opération de la routine de rappel par défaut et doit être passée à la routine de rappel. Pour ce faire, spécifiez le pointeur void comme contexte dans un appel à SetupCommitFileQueue, ou en spécifiant le pointeur void en tant que paramètre de contexte lors de l’appel de SetupDefaultQueueCallback à partir d’une routine de rappel personnalisée. Cette structure de contexte ne doit pas être modifiée ou référencée par l’application d’installation.

La fonction SetupInitDefaultQueueCallbackEx initialise également un contexte pour la routine de rappel de file d’attente par défaut, mais elle spécifie une deuxième fenêtre pour recevoir un message de progression spécifié par l’appelant chaque fois que la file d’attente envoie une notification. Cela vous permet d’utiliser les boîtes de dialogue d’invite de disque et d’erreur par défaut, ainsi que d’incorporer une barre de progression dans une deuxième fenêtre, par exemple, dans une page d’un Assistant Installation.

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ée, appelez SetupTermDefaultQueueCallback pour libérer les ressources allouées à l’initialisation de la structure de contexte.