WinAPPCStartup()

This function enables an application to specify the version of Personal Communications required and to retrieve version information from Personal Communications. This call is not required.

Syntax

int WINAPI WinAPPCStartup(WORD wVersionRequired,
                          LPWAPPCDATA wappcdata);

Parameters

wVersionRequired
Specifies the version of Personal Communications support required. The high-order byte specifies the minor version (revision) number; the low-order byte specifies the major version number.
wappcdata
Returns the version of APPC API and a description of API implementation.

Returned Values

The return value specifies whether Personal Communications successfully registered the application and whether it can support the specified version number. If the value is 0, Personal Communications supports the specified version and it successfully registers the application. Otherwise, one of the following values is returned:
WAPPCSYSNOTREADY
The underlying network subsystem is not ready for network communication.
WAPPCVERNOTSUPPORTED
This particular Personal Communicationsor Communications Server implementation does not support the version of Personal Communicationsor Communications Server support requested.
WAPPCINVALID
Personal Communications and Communications Server could not determine the specified version.

Usage Notes

WinAPPCStartup() is intended to help with compatibility of future releases of the API. This DLL supports Version 1.0.
See also:
WinAPPCCleanup().