E-mail Delivery Reports

If a system has multiple users, or if the system belongs to a network, the e-mail delivery method for fax delivery reports (DRs) and non-delivery reports (NDRs) may be appropriate. An example of a system with multiple users is a fax server connected to one or more client machines.

For e-mail delivery of DRs and NDRs, the fax server requires the following items:

• A dedicated MAPI profile from which the fax server originates e-mail
• A connection to a Microsoft Exchange Server
• An Exchange Server mailbox name or alias to which the fax server will send e-mail

To request e-mail delivery of DRs and NDRs, a fax client application must perform the steps described following for the Win32 and COM implementation environments.

In the Win32 Environment

To request e-mail delivery of DRs and NDRs

1. Call the FaxSetConfiguration function and specify a valid MAPI user profile in the InboundProfile member of the FAX_CONFIGURATION structure. The fax service must have access to the specified profile. (This may require a change to the fax service account using the Manage Computer/Services application, a Microsoft Management Console snap-in component.)
2. Change the configuration parameters of the fax service account using a call to the ChangeServiceConfig function. (Alternatively, you can use the System Service Management application, a Microsoft Management Console snap-in component, to change the fax service account.)
3. Restart the fax service using the fax service administration application, a Microsoft Management Console (MMC) snap-in component, or by calling the StartService function.
4. Request e-mail delivery of DRs and NDRs in one of the following ways:
   • Call the FaxStartPrintJob function and specify the DrEmailAddress member of the FAX_PRINT_INFO structure. The specified e-mail address must be a valid address or alias in the Microsoft Exchange Server global address list (GAL).

     – Or –

   • Call the FaxSendDocument function or the FaxSendDocumentForBroadcast function and specify a valid e-mail address in the DeliveryReportAddress member of the FAX_JOB_PARAM structure. You must also specify DRT_EMAIL in the DeliveryReportType member.

The fax server will send an e-mail DR or NDR from the e-mail address specified by the InboundProfile member in step 1, to the e-mail address specified by the DrEmailAddress member or the DeliveryReportAddress member in step 4.

In the COM Implementation Environment

To request e-mail delivery of DRs and NDRs

1. Set the ServerMapiProfile property of the FaxServer object. The property must specify a valid MAPI profile.
2. Set the EmailAddress property of the FaxDoc object. The e-mail address must be a valid address or alias in the Microsoft Exchange Server global address list (GAL).
3. Follow steps 2 and 3 listed previously for the Win32 environment.

The fax server will send an e-mail DR or NDR from the e-mail address specified by ServerMapiProfile property to the e-mail address specified by the EmailAddress property.

For more information, see IFaxServer::put_ServerMapiProfile and IFaxDoc::put_EmailAddress. If you are writing a Visual Basic application, see FaxServer object (Visual Basic) and FaxDoc object (Visual Basic) for more information about these properties.