User`s guide

Contents cv
App
versions
DLL
Versions
To
WinHLLAPI
Startup
From
WinHLLAPI
Startup Result
1.0 1.0 1.0 1.0 use 1.0
1.0 2.0 1.0 2.0 1.0 use 1.0
1.0 1.0 2.0 1.0 2.0 use 1.0
1.0 2.0 3.0 1.0 WHLLINVALID fail
2.0 3.0 1.0 3.0 1.0 app fails
1.0 2.0 3.0 1.0 2.0 3.0 3.0 3.0 use 3.0
Having made its last Windows HLLAPI call, an application should call the WinHLLAPICleanup( )
routine.
Parameter Type Description
wVersionRequired WORD
Specifies the version of Windows HLLAPI support
required. The high order byte specifies the minor
version (revision) number; the low-order byte
specifies the major version number.
lpData Structure Containing information about the underlying
Windows HLLAPI DLL implementation. The first
wVersion field has the same structure as the
wVersionRequired parameter and the
szDescription field contains a string identifying the
vendor of the Windows HLLAPI DLL. The
description field is only meant to provide a display
string for the application and should not be used to
programatically distinguish between Windows
HLLAPI implementations.
The return value indicates whether the application was registered successfully and whether the
Windows HLLAPI implementation can support the specified version number. It is zero if it was
registered successfully and the specified version can be supported; otherwise it is one of the following
return codes:
WHLLSYSNOTREADY Indicates that the underlying network subsystem is not
ready for network communication.
WHLLVERNOTSUPPORTED The version of Windows HLLAPI support requested is
not provided by this particular Windows HLLAPI
implementation.
WHLLINVALID The Windows HLLAPI version specified by the
application is not supported by this DLL.
Windows HLLAPI Supplier Notes
Each Windows HLLAPI implementation must make a WinHLLAPIStartup( ) call before issuing any
other Windows HLLAPI calls. This function can thus be used for initialization purposes.
See also: WinHLLAPICleanup( )
Returns