HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
WinCPICStartup
Chapter 3 309
Returned Values
The return value from the function is one of the following:
0 (zero) The application was registered successfully, and the
Windows CPI-C software supports either the version
number specified by the application or a lower version.
The application should checkthe versionnumber in the
WCPICDATA structure (see the description that
follows) to ensure that it is high enough.
WCPICVERNOTSUPPORTED The version number specified by the application
was lower than the lowest version supported by the
Windows CPI-C software. The application was not
registered.
WCPICSYSNOTREADY The SNAplus2 software has not been started, or the
local node is not active. The application was not
registered.
If the return value from WinCPICStartup() is 0 (zero), the WCPICDATA
structure contains information about the support provided by the
Windows CPI-C 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 CPI-C version number that the software
supports,in the same format asthe wVersionRequired
parameter (see the previous explanation). SNAplus2
supports version 1.0.
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
will be 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 CPI-C implementation.
• If the returned version number is lower than the
requested version number, the application can use
this Windows CPI-C implementation but must not