Extensions pour l’environnement Windows
Cette section décrit les extensions d’API de Microsoft® Windows® Common Programming Interface for Communications (CPI-C) qui autorisent l’exécution de verbes non bloquants ou asynchrones. Les verbes asynchrones retournent immédiatement le contrôle au programme, sans attendre l’exécution complète, et doivent notifier l’application ultérieurement lorsque le verbe est terminé. Une application est également avertie en réponse à la fin d’un appel de Wait_For_Conversation . En revanche, les verbes synchrones bloquent, c’est-à-dire que l’appel de fonction ne retourne pas tant que l’appel n’est pas terminé.
Sous Microsoft® Windows Server, deux méthodes sont disponibles pour gérer la saisie semi-automatique asynchrone des verbes :
Publication de messages à l’aide de handles de fenêtre.
En attente sur les événements Win32®.
La première méthode utilise des messages publiés dans un handle de fenêtre pour notifier une application de saisie semi-automatique. Il existe une fenêtre de ce type pour chaque application CPI-C. Chaque conversation CPI-C peut avoir un verbe asynchrone en attente à tout moment. Lorsqu’un verbe se termine, la publication dans la fenêtre prend en tant que paramètres l’identificateur de conversation CPI-C du verbe qui s’est terminé et le code de retour du verbe.
Notes
Les extensions utilisant des handles de fenêtre et la publication de messages décrites dans cette section ont été conçues pour toutes les implémentations et versions de Microsoft Windows. Ils sont désormais pris en charge uniquement pour Windows.
Une deuxième méthode utilisant des événements Win32 pour la notification est prise en charge sur Microsoft® Host Integration Server. Les extensions utilisant des événements Win32 décrits dans cette section (WinCPICSetEvent et WinCPICExtractEvent) fonctionnent uniquement sur Windows Server et offrent des performances d’application optimales dans l’environnement d’exploitation 32 bits. Si un événement a été inscrit avec la conversation, une application peut appeler la fonction Win32 WaitForSingleObject ou WaitForMultipleObjects pour attendre d’être avertie de la fin du verbe.
Windows CPI-C autorise les processus Windows multithread. Le multithreading est l’exécution de plusieurs processus dans une séquence rapide au sein d’un même programme. Un processus contient un ou plusieurs threads d’exécution.
Les descriptions d’extension de cette section fournissent une définition de la fonction, de la syntaxe, des valeurs de retour et des remarques pour l’utilisation de ces extensions Windows dans les programmes CPI-C.