HP-UX SNAplus2 R7 APPC Programmer's Guide

Writing Transaction Programs
APPC Entry Points: Windows Systems
When the application has finished issuing APPC verbs, it must call WinAPPCCleanup before terminating. After
calling WinAPPCCleanup, the application must not attempt to issue any more APPC verbs (unless it first calls
WinAPPCStartup to reinitialize).
The following sections describe these Windows entry points.
2.4.1 WinAPPCStartup
The application uses WinAPPCStartup to register as a Windows APPC user and to determine whether the APPC
software supports the Windows APPC version that the application requires.
Function Call
int WINAPI WinAPPCStartup (
WORD wVersionRequired;
WAPPCDATA far * lpData;
)
typedef struct
{
WORD wVersion;
char szDescription[128];
} WAPPCDATA;
Supplied Parameters
When the application uses the WinAPPCStartup entry point to issue a verb, it supplies the following parameters:
wVersionRequired
The version of Windows APPC that the application requires. The low-order byte specifies the major version
number, and the high-order byte specifies the minor version number. For example:
Version wVersionRequired
1.0
0x0001
1.1
0x0101
2.0
0x0002
If the application can use more than one version, it specifies the highest version that it can use.
Returned Values
WinAPPCStartup returns one of the following values:
0
(zero)
The application was registered successfully and the Windows APPC software supports either the version
number specified by the application or a lower version. The application should check the version number in
the
WAPPCDATA structure to ensure that it is high enough.
WAPPCVERNOTSUPPORTED
The version number specified by the application was lower than the lowest version supported by the Windows
APPC software. The application was not registered.
WAPPCSYSNOTREADY
The application was not registered. This may be because the SNAplus2 software has not been started, or the
local node is not active, or because of another system failure such as a resource shortage.
55