Before Using Windows LUA

The following Windows extensions are of particular importance and should be reviewed before using the LUA API and this version of SNA Server:

RUI

Provides event notification for all RUI verbs. The application must provide a handle to an event in the lua_post_handle member of the verb control block (VCB). The event must be in the not-signaled state. When the asynchronous operation is complete, the application is notified through the signaling of the event. Upon signaling of the event, examine the primary return code and secondary return code for any error conditions.

SLI

Provides event notification for all SLI verbs. The application must provide a handle to an event in the lua_post_handle member of the VCB. The event must be in the not-signaled state. When the asynchronous operation is complete, the application is notified through the signaling of the event. Upon signaling of the event, examine the primary return code and secondary return code for any error conditions.

WinRUI

Provides asynchronous notification for all Windows-based RUI verbs. When the asynchronous operation is complete, the application's window hWnd receives the message returned by RegisterWindowMessage with "WinRUI" as the input string. The lParam argument of the message contains the address of the VCB being posted as complete. The wParam argument of the message is undefined.

An application must call WinRUIStartup for initialization before calling WinRUI.

WinRUICleanup

An application must call this function when finished using RUI verbs to deregister itself from the Windows LUA implementation. This function terminates and deregisters an application from a Windows LUA implementation.

WinRUIStartup

An application must call this function to register itself with a Windows LUA implementation before issuing any further Windows LUA calls using RUI verbs. This function allows an application to specify the version of Windows LUA required and to retrieve details of the specific LUA implementation.

WinSLI

Provides asynchronous notification for all Windows-based SLI verbs. When the asynchronous operation is complete, the application's window hWnd receives the message returned by RegisterWindowMessage with "WinSLI" as the input string. The lParam argument of the message contains the address of the VCB being posted as complete. The wParam argument of the message is undefined.

An application must call WinSLIStartup for initialization before calling WinSLI.

WinSLICleanup

An application must call this function when finished using SLI verbs to deregister itself from the Windows LUA implementation. This function terminates and deregisters an application from a Windows LUA implementation.

WinSLIStartup

An application must call this function to register itself with a Windows LUA implementation before issuing any further Windows LUA calls using SLI verbs. This function allows an application to specify the version of Windows LUA required and to retrieve details of the specific LUA implementation.