HP-UX SNAplus2 R7 LUA Programmer's Guide

Designing and Writing LUA Applications
LUA Entry Points for Windows Applications
Issues an SLI verb. If the verb completes asynchronously, LUA will indicate the completion by posting a
message to the application window.
WinSLICleanup
Unregisters the application when it has finished using SLI.
An RUI application must call WinRUIStartup before attempting to issue any LUA verbs using the WinRUI call.
While an RUI_INIT verb is outstanding, the application can use WinRUIGetLastInitStatus to determine
the status of the LUA session initiated by this verb; it can then cancel the RUI_INIT verb if necessary. The
WinRUIGetLastInitStatus function can be used to check the current status without requesting notification of
subsequent changes, to request asynchronous notification of subsequent changes to the session status, or to cancel
a previous request for notification of status changes.
If a verb returns with non-LUA_OK return codes, the application can use GetLuaReturnCode to obtain a text
string representation of these return codes, which can be used to generate standard error messages.
When it has finished issuing LUA verbs using the WinRUI call, it must call WinRUICleanup before terminating;
it must not attempt to issue any more RUI verbs after calling WinRUICleanup.
An SLI application must call WinSLIStartup before attempting to issue any LUA verbs using the WinSLI call.
If a verb returns with non-LUA_OK return codes, the application can use GetLuaReturnCode to obtain a text
string representation of these return codes, which can be used to generate standard error messages.
When it has finished issuing LUA verbs using the WinSLI call, it must call WinSLICleanup before terminating;
it must not attempt to issue any more SLI verbs after calling WinSLUICleanup.
The following sections describe these functions.
2.2.1 RUI
The application uses this function to issue an LUA RUI verb. If the verb completes asynchronously, LUA indicates
the completion by signaling an event handle supplied by the application.
The application does not need to issue a WinRUIStartup verb before making this call.
Function Call
void WINAPI RUI(verb)
LUA_VERB_RECORD FAR * verb;
Supplied Parameters
Supplied parameter is:
verb
Pointer to a Verb Control Block (VCB) that contains the parameters for the verb being issued. The VCB
structure is defined in the LUA header file winlua.h; this file is installed in the subdirectory /sdk within
the directory where you installed the Windows Client software. For an explanation of the VCB structure, see
Chapter 3, LUA VCB Structure.
28