Finalización de verbos sincrónica y asincrónica en LUA

Los verbos de aplicación de unidad lógica (LUA) pueden completar la ejecución de forma sincrónica o asincrónica.

Finalización sincrónica del verbo

Cuando LUA puede completar todo el procesamiento de un verbo tan pronto como se emita, el verbo se ha completado de forma sincrónica. Cuando esto sucede, el código de retorno principal se establece en un valor distinto de LUA_IN_PROGRESS y el bit lua_flag2.async se establece en cero.

El valor del bit lua_flag2.async debe probarse, no el código de retorno principal no es igual a LUA_IN_PROGRESS. (Para obtener información sobre estos parámetros devueltos, vea descripciones de los verbos individuales).

Finalización asincrónica del verbo

Algunos verbos LUA (por ejemplo, RUI_PURGE) se completan rápidamente después del procesamiento local. Sin embargo, la mayoría de los verbos tardan algún tiempo en completarse porque requieren que los mensajes se envíen y reciban desde el nodo local o la aplicación host.

Cuando LUA debe esperar información desde la LU remota o desde el nodo local para poder completar un verbo, el verbo se completa de forma asincrónica.

Cuando esto sucede, el bit lua_flag2.async se establece en 1. El código de retorno principal también se establece normalmente en LUA_IN_PROGRESS, pero no se puede confiar en este valor. Se debe probar el valor del bit lua_flag2.async . La aplicación ahora puede realizar otro procesamiento o esperar la notificación de LUA de que el verbo se ha completado. LUA emite esta notificación estableciendo el código de retorno principal en su valor final y dejando lua_flag2.async establecido en 1.

Cuando se completa el verbo, LUA hace lo siguiente en función de su entorno:

• Para Windows, son posibles dos tipos de notificación. La aplicación LUA: o bien

  Emite WaitForSingleObject o WaitForMultipleObject.

  -O bien-

  Publica el mensaje de notificación "WinRUI/WinSLI" en el identificador de ventana del mensaje WinRUI/WinSLI.

  El método de evento mediante WaitForSingleObject o WaitForMultipleObject es la forma preferida de recibir una notificación asincrónica en Windows.

• En el entorno de Windows, notifica la finalización de una solicitud asincrónica publicando el mensaje de notificación "WinRUI/WinSLI" en el identificador de ventana del mensajeWinSLI de /. Se ha agregado un identificador de ventana como primer parámetro que se pasa a los puntos de entrada WinRUI y WinSLI.