HP-UX SNAplus2 R7 LUA Programmer's Guide

Designing and Writing LUA Applications
LUA Entry Points for Windows Applications
The supplied data buffer is too small to hold the returned character string.
0x20000003
The dynamic link library, LUASTR32.DLL, which generates the returned character strings for this function,
could not be loaded.
If the return value is
0
(zero), the returned character string is in the buffer identified by the
buffer_addr parameter.
This string is terminated by a null character (binary zero), but does not include a trailing new-line
(\n) character.
2.2.7 SLI
The application uses this function to issue an LUA SLI verb. If the verb completes asynchronously, LUA indicates
the completion by signaling an event handle supplied by the application.
Function Call
void WINAPI SLI(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.
Note
The LUA VCB contains many parameters marked as “reserved”; some of these are
used internally by the SNAplus2 software, and others are not used in this version
but may be used in future versions. Your application must not attempt to access any
of these reserved parameters; instead, it must set the entire contents of the VCB to
zero to ensure that all of these parameters are zero, before it sets other parameters
that are used by the verb. This ensures that SNAplus2 will not misinterpret any of
its internally-used parameters, and also that your application will continue to work
with future SNAplus2 versions in which these parameters may be used to provide
new functions.
To set the VCB contents to zero, use memset:
memset(vcb, 0, sizeof(vcb));
Returned Values
The entry point does not return a value. When the call returns, the application can examine the parameters in
the VCB to determine whether the verb has completed synchronously or will complete asynchronously. For more
information, see Section 2.2.7, SLI.
Usage
Sometimes LUA is able to complete all the processing for a verb as soon as it is issued. When this happens,
the verb returns synchronously; the primary return code is set to a value other than
LUA_IN_PROGRESS, and the
lua_flag2.async bit is set to 0 (zero). (For information about these returned parameters, see Chapter 5, SLI Verbs.)
At other times, LUA must wait for information from the remote LU or from the node before it can complete the
verb. In this case, the verb returns asynchronously; the primary return code is set to
LUA_IN_PROGRESS, and the
37