Sending a Cover Page (Win32 Environment)

You can send a personal cover page or a common cover page located on a server with a fax transmission.

To transmit a cover page with a fax, call the FaxSendDocument function or the FaxSendDocumentForBroadcast function.

When you call the FaxSendDocument function to transmit a fax, you must supply a pointer to a FAX_COVERPAGE_INFO structure. The structure provides the name of a cover page template file and an indication of whether the file is located locally or on the fax server. The structure can also contain user-supplied information to display on the cover page.

To send a common cover page

• Provide a pointer to a FAX_COVERPAGE_INFO structure when you call the FaxSendDocument function.
• Set the UseServerCoverPage member of the FAX_COVERPAGE_INFO structure equal to TRUE.
• Specify a valid common cover page file in the CoverpageName member of the FAX_COVERPAGE_INFO structure.

To send a personal cover page

• Provide a pointer to a FAX_COVERPAGE_INFO structure when you call the FaxSendDocument function.
• Set the UseServerCoverPage member of the FAX_COVERPAGE_INFO structure equal to FALSE.
• Specify a valid personal cover page file that the fax server can access in the CoverpageName member of the FAX_COVERPAGE_INFO structure.

To determine if the fax server is configured to permit personal cover pages, you can call the FaxGetConfiguration function.

If your application calls the FaxSendDocumentForBroadcast function to transmit a fax to multiple recipients, the function calls the FAX_RECIPIENT_CALLBACK function. You must provide a pointer to a FAX_COVERPAGE_INFO structure when you call FAX_RECIPIENT_CALLBACK and set the members as outlined previously. The callback function can retrieve user-specified cover page information for each designated fax recipient.