HP-UX SNAplus2 R7 APPC Programmer's Guide

Writing Transaction Programs
APPC Entry Points: Windows Systems
If the return value from WinAPPCStartup is
0
(zero), the
WAPPCDATA
structure contains information about the
support provided by the Windows APPC software. If the return value is nonzero, the contents of this structure are
undefined and the application should not check them. The parameters in this structure are as follows:
wVersion
The Windows APPC version number that the software supports, in the same format as the wVersionRequired
parameter. If the software supports the requested version number, this parameter is set to the same value as
the wVersionRequired parameter; otherwise it is set to the highest version that the software supports, which
is lower than the version number supplied by the application. The application must check the returned value
and take action as follows:
• If the returned version number is the same as the requested version number, the application can use this
Windows APPC implementation.
• If the returned version number is lower than the requested version number, the application can use this
Windows APPC implementation but must not attempt to use features that are not supported by the returned
version number. If it cannot do this because it requires features not available in the lower version, it should
fail its initialization and not attempt to issue any APPC verbs.
szDescription
A text string describing the Windows APPC software.
2.4.2 WinAsyncAPPC
The application uses this function to issue an APPC verb. If the verb completes asynchronously, APPC indicates
the completion by posting a message to the application’s Windows handle.
Before using the WinAsyncAPPC call for the first time, the application must use the RegisterWindowMessage
call to obtain the message identifier that APPC will use for messages indicating asynchronous verb completion. For
more information, see Section 2.4.2, WinAsyncAPPC.
Function Call
HANDLE WINAPI WinAsyncAPPC (
HWND hWnd,
long vcbptr
);
Supplied Parameters
The supplied parameters are:
hWnd
A Windows handle that APPC will use to post a message indicating asynchronous verb completion.
vcbptr
A pointer to the VCB structure for the verb. This parameter is defined as a long integer, and so needs to be
cast from a pointer to a long integer. For more information about the VCB structure and on its usage for
individual verbs, see Chapter 3, APPC Control Verbs and Chapter 4, APPC Conversation Verbs.
56