User`s guide

civ Contents
WinHLLAPIStartup( )
This function allows an application to specify the version of Windows HLLAPI required and to retrieve
details of the specific Windows HLLAPI implementation. This function MUST be called by an
application before issuing any further Windows HLLAPI calls to register itself with a Windows
HLLAPI implementation.
int WinHLLAPIStartup(WORD wVersionRequired, LPWHLLAPIDATA
lpData)
In order to support future Windows HLLAPI implementations and applications that may have
functionality differences from Windows HLLAPI version 1.0, a negotiation takes place in
WinHLLAPIStartup( ). An application passes to WinHLLAPIStartup( ) the Windows HLLAPI
version of which it can take advantage. If this version is lower than the lowest version supported by the
Windows HLLAPI DLL, then the DLL cannot support the application and the WinHLLAPIStartup( )
call fails. Otherwise, the call succeeds and returns the highest version of Windows HLLAPI supported
by the DLL. If this version is lower than the lowest version supported by the application, the
application either fails its initialization or attempts to find another Windows HLLAPI DLL on the
system.
This negotiation allows both a Windows HLLAPI DLL and a Windows HLLAPI application to support
a range of Windows HLLAPI versions. An application can successfully use a DLL if there is any
overlap in the versions. The following chart gives examples of how WinHLLAPIStartup( ) works in
conjunction with different application and DLL versions:
Details of the actual Windows HLLAPI implementation are described in the WHLLAPIDATA
structure defined as follows:
typedef struct tagWHLLAPIDATA {
WORDwVersion;
char szDescription[WHLLDESCRIPTION_LEN+1];
} WHLLAPIDATA, * PWHLLAPIDATA, FAR * LPWHLLAPIDATA;
Syntax