HP-UX SNAplus2 R7 APPC Programmer's Guide

Writing Transaction Programs
APPC Entry Points: Windows Systems
int far *AsyncRetCode
);
Supplied Parameters
The supplied parameters are:
hWnd
A Windows handle that APPC will use to post a message indicating asynchronous completion of this call. If
this parameter is used, the pointer to the
AsyncRetCode parameter must be a null pointer.
LocalLU
A pointer to the alias of the local LU for which configuration information is required. This is an ASCII string
of up to eight characters, terminated with a null character (binary zero); if the LU alias is shorter than eight
characters, it must be followed immediately by the null character and not space-padded.
To indicate the default local LU, set this parameter to point to a string consisting of eight ASCII spaces
followed by a null character.
Mode
A pointer to the name of the mode (used by the local LU) for which configuration information is required.
This is an ASCII string of up to eight characters, terminated with a null character (binary zero); if the mode
name is shorter than eight characters, it must be followed immediately by the null character and not space-
padded. For 5250 emulation programs, the mode name is normally
QPCSUPP.
NumRemLU
A pointer to an integer that APPC can use to return the number of remote LUs configured.
MaxRemLU
The maximum number of remote LU aliases that can be accommodated in the supplied data buffer (see the
following parameter). Each LU alias requires 9 bytes, so the length of the supplied buffer must be at least
nine times the supplied value of MaxRemLU.
RemLU
A buffer to contain the returned remote LU aliases.
AsyncRetCode
If the application is using the recommended method of indicating completion, this parameter is reserved; the
application must supply a null pointer.
If the application is using the alternative method, this parameter is a pointer to the integer that APPC uses
for the asynchronous return code from the function. In this case, the hWnd parameter must be a null handle.
Returned Values
When the call returns, the application can test the value of the expression “ReturnedHandle &
APPC_CFG_SUCCESS ” to determine whether the function was successful.
If the value of the expression “ReturnedHandle & APPC_CFG_SUCCESS” is
TRUE, and the application is using
the recommended method to indicate completion, the return value is a handle. When the function later completes,
APPC uses this handle as an identifier in the message passed to the application’s window procedure (for more
information, see Section 2.4.12, GetAppcConfig).
If the value of the expression “ReturnedHandle & APPC_CFG_SUCCESS” is
TRUE, and the application is using
the alternative method to indicate completion, the AsyncRetCode parameter is set to
APPC_CFG_PENDING. The
application should test this value periodically to check for completion. When the function later completes, APPC
sets this parameter to one of the asynchronous return codes listed in Section 2.4.12, GetAppcConfig.
If the value of the expression is
FALSE, the function call was not accepted. The value of ReturnedHandle is one of
the following:
64