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.