Compatibility

Called during the initialization process. It passes the GroupWise client version to the TPH via this method. You can determine the version by evaluating the high and low order bytes of the AppVersion parameter. This function must be exported as ordinal value 2 (two).

Syntax

DWORD WINAPI Compatibility ( 
   ATOM AppName, 
   WORD AppVersion );

Parameters

AppName

Atom of the calling application. See a Windows programming manual for Atoms information.

AppVersion

GroupWise version being loaded for the calling application.

Return Values

Make sure the Compatibility() return value is TRUE or FALSE cast as a DWORD value. An incompatible DLL returns FALSE.

Example

DWORD WINAPI Compatibility( ATOM AppAtom, WORD AppVersion) 
{
     // Greater than or equal to GroupWise 5.2
     if (5 >= LOBYTE(AppVersion) && 2 >= HIBYTE(AppVersion)) 
     {
          return (DWORD) TRUE;
     }
     else 
     {
          return (DWORD) FALSE;
     }
}

Remarks

Compatibility() lets a DLL specify the GroupWise version to load it with and ensures compatibility between GroupWise and third-party DLLs. Your DLL can verify major and minor GroupWise versions, then return GroupWise a value indicating whether to load your DLL. A Novell application name and GroupWise version are passed as parameters to Compatibility(). You must export Compatibility() at ordinal value 2 (two).

The GroupWise AppName is GROUPWISE. The AppVersion is a word value with the low-order byte containing the GroupWise major version, and the high-order byte containing the minor version.