<< Click to Display Table of Contents >>
Get user's default coversheet.
ZFERR FAR ZfxGetUserCoversheet( ZFSESSIONHANDLE hSession, char FAR *lpszBuffer, short BufLen)
API session handle, as returned by ZfxAPIInit calllpszBufferAddress of buffer used to return the full path of the directory, including a terminating backslash ('\') and NULL.
Size of the buffer (including space for the terminating NULL)
Each user in Zetafax can set their own default setting for the coversheet they want to use. This routine returns the name of their default coversheet, or a null string if their default setting is for no coversheet to be sent.
The routine need only be called if the program wants to perform specific processing on the coversheet name (for example, overriding it if blank), as the default will automatically be used if the "Coversheet:" line is omitted from a SUBMIT file.
The maximum length of coversheet names equal to ZFMSG_COVERSHEET_LEN (excluding space for the terminating NULL).
The routine returns 0 if successful, otherwise one of the following:
if (ZfxGetUserCoversheet(hSession, szCoversheet, sizeof(szCoversheet)) != 0
|| szCoversheet == '\0') /*if default is no coversheet */
/* force a coversheet to be used */