Extensions APPC pour l’environnement Windows
Cette section décrit les extensions d’API pour windows Advanced Program Communications (APPC) qui autorisent la communication asynchrone. La communication asynchrone se produit lorsqu’une fonction retourne avant la fin de la demande. L’application est avertie ultérieurement lorsque la demande est terminée.
Sous Microsoft® Windows®, trois méthodes sont disponibles pour la communication asynchrone à l’aide de l’API APPC :
Publication de messages à l’aide de handles de fenêtre.
En attente d’événements Win32®.
Utilisation des ports d’achèvement d’E/S Win32.
La première méthode utilise des messages publiés dans un handle de fenêtre pour notifier une application de l’achèvement du verbe. Cette méthode utilisant des handles de fenêtre et des messages a été prise en charge sur Microsoft Windows 3.x. Il existe une fenêtre de ce type pour chaque application APPC, indépendamment du nombre de conversations. Chaque conversation APPC peut avoir un verbe asynchrone en attente à tout moment. Lorsqu’un verbe se termine, la publication dans la fenêtre prend comme paramètres le handle de tâche asynchrone retourné par l’appel d’origine et un pointeur vers le bloc de contrôle de verbe qui s’est terminé, contenant les codes de retour du verbe.
Les extensions utilisant les handles de fenêtre et la publication de messages décrites dans cette section (WinAsyncAPPC) ont été conçues pour toutes les implémentations et versions de Microsoft Windows de la version 3.0 jusqu’aux dernières versions de Windows. Ils fournissaient la compatibilité pour la programmation Windows et des performances d’application optimales dans l’environnement d’exploitation Windows 16 bits.
Une deuxième méthode utilisant des événements Win32 pour la notification est prise en charge. Les extensions utilisant des événements Win32 décrits dans cette section (WinAsyncAPPCEx) fonctionnent uniquement sur Windows et offrent des performances d’application optimales dans l’environnement d’exploitation Windows 32 bits. Si un événement a été inscrit auprès de la conversation, une application peut appeler la fonction Win32 WaitForSingleObject ou WaitForMultipleObjects pour attendre d’être informée de la fin du verbe.
Une troisième méthode utilisant des ports d’achèvement d’E/S Win32 pour la notification est prise en charge sur Windows. Les extensions utilisant des ports d’achèvement d’E/S décrits dans cette section (WinAsyncAPPCIOCP) fonctionnent uniquement sur Windows et offrent des performances d’application optimales dans l’environnement d’exploitation Windows 32 bits. Si un port d’achèvement d’E/S a été créé à l’aide de CreateIoCompletionPort, une application peut appeler la fonction Win32 GetQueuedCompletionStatus pour attendre d’être avertie de l’achèvement du verbe.
Windows APPC autorise les processus Windows multithread. Un processus contient un ou plusieurs threads d’exécution. Toutes les références aux threads dans ce document font référence à des threads réels dans des environnements Windows multithread.
Cette section fournit, pour chaque extension, une définition de la fonction, la syntaxe, les retours et les remarques pour l’utilisation de la fonction.