Extensiones de APPC para el entorno Windows
En esta sección se describen las extensiones de API para las comunicaciones avanzadas de programa a programa (APPC) de Windows que permiten la comunicación asincrónica. La comunicación asincrónica se produce cuando una función vuelve antes de que se complete la solicitud. La aplicación se notifica más adelante cuando se completa la solicitud.
En Microsoft® Windows®, hay tres métodos disponibles para la comunicación asincrónica mediante la API de APPC:
Publicación de mensajes mediante identificadores de ventana.
Esperando eventos win32®.
Usar puertos de finalización de E/S de Win32.
El primer método usa mensajes publicados en un identificador de ventana para notificar a una aplicación la finalización del verbo. Este método con identificadores de ventana y mensajes se admite en Microsoft Windows 3.x. Hay una ventana de este tipo para cada aplicación APPC, independientemente del número de conversaciones. Cada conversación de APPC puede tener un verbo asincrónico pendiente en cualquier momento. Cuando se completa un verbo, la publicación en la ventana toma como parámetros el identificador de tarea asincrónico devuelto por la llamada original y un puntero al bloque de control de verbo que se ha completado, que contiene los códigos de retorno del verbo.
Las extensiones que usan identificadores de ventana y publicación de mensajes descritos en esta sección (WinAsyncAPPC) se diseñaron para todas las implementaciones y versiones de Microsoft Windows desde la versión 3.0 hasta las versiones más recientes de Windows. Proporcionaron compatibilidad con la programación de Windows y un rendimiento óptimo de la aplicación en el entorno operativo Windows de 16 bits.
Se admite un segundo método con eventos Win32 para la notificación. Las extensiones que usan eventos Win32 que se describen en esta sección (WinAsyncAPPCEx) solo funcionan en Windows y ofrecen un rendimiento óptimo de la aplicación en el entorno operativo Windows de 32 bits. Si se ha registrado un evento con la conversación, una aplicación puede llamar a la función WaitForSingleObject o WaitForMultipleObjects de Win32 para esperar a que se le notifique la finalización del verbo.
En Windows se admite un tercer método que usa puertos de finalización de E/S de Win32 para la notificación. Las extensiones que usan puertos de finalización de E/S que se describen en esta sección (WinAsyncAPPCIOCP) solo funcionan en Windows y ofrecen un rendimiento óptimo de la aplicación en el entorno operativo Windows de 32 bits. Si se ha creado un puerto de finalización de E/S mediante CreateIoCompletionPort, una aplicación puede llamar a la función GetQueuedCompletionStatus de Win32 para esperar a que se le notifique la finalización del verbo.
Windows APPC permite procesos multiproceso basados en Windows. Un proceso contiene uno o varios subprocesos de ejecución. Todas las referencias a subprocesos de este documento hacen referencia a subprocesos reales en entornos multiproceso de Windows.
En esta sección se proporciona, para cada extensión, una definición de la función, la sintaxis, las devoluciones y los comentarios para usar la función .