<< Click to Display Table of Contents >>
Get version identifier for API routines.
ZFERR FAR ZfxGetAPIVersion( char FAR *lpszBuffer, short BufLen, unsigned short FAR *lpusVersion)
Address of buffer to store version identifier string, or NULL if not required. BufLenLength of buffer (including space for terminating null)
Address of unsigned short integer variable used to return the version number of the API routines, or NULL if not required.
This routine gets a version identifier for the API routines. The version identifier is 20 characters or fewer (generally about 5 characters plus terminating null), and may be used when displaying the version number an application program.
The numeric version number will allow future programs to detect when they are running with an older version of the API. This is currently set to 0x600 (hex) - it is recommended that programs do not object if this number is higher than expected to allow for future updates to the API without the need to rebuild the programs.
The routine returns 0 if successful, otherwise one of the following:
unsigned short usVersion;
printf("Automatic invoicing program v2.27\n");
if (ZfxGetAPIVersion(szVersion, sizeof(szVersion), &usVersion) == 0)
printf("Zetafax API version %s\n", szVersion);