FAX_PRINT_INFO

The FAX_PRINT_INFO structure contains the information necessary for the fax server to print a fax transmission. The structure includes sender and recipient data, an optional billing code, and delivery report information.

The SizeOfStruct and RecipientNumber members are required; other members are optional.

typedef struct _FAX_PRINT_INFO {
  DWORD    SizeOfStruct;       // structure size, in bytes
  LPCTSTR  DocName;            // pointer to document name to display
  LPCTSTR  RecipientName;      // pointer to recipient's name
  LPCTSTR  RecipientNumber;    // pointer to recipient's fax number
  LPCTSTR  SenderName;         // pointer to sender's name
  LPCTSTR  SenderCompany;      // pointer to sender's company
  LPCTSTR  SenderDept;         // pointer to sender's department
  LPCTSTR  SenderBillingCode;  // pointer to billing code
  LPCTSTR  DrProfileName;      // e-mail profile for DR or NDR
  LPCTSTR  DrEmailAddress;     // pointer to e-mail address
  LPCTSTR  OutputFileName;     // reserved; must be NULL
} FAX_PRINT_INFO, *PFAX_PRINT_INFO; 

Members

SizeOfStruct

Specifies the size, in bytes, of the FAX_PRINT_INFO structure. The calling application must set this member to sizeof(FAX_PRINT_INFO). This member is required.

DocName

Pointer to a constant null-terminated character string that is the user-friendly name that appears in the print spooler.

RecipientName

Pointer to a constant null-terminated character string that specifies the name of the recipient of the fax transmission.

RecipientNumber

Pointer to a constant null-terminated character string that specifies the fax number of the recipient of the fax transmission. This member is required.

SenderName

Pointer to a constant null-terminated character string that specifies the name of the sender who initiated the fax transmission.

SenderCompany

Pointer to a constant null-terminated character string that specifies the company name of the sender who initiated the fax transmission.

SenderDept

Pointer to a constant null-terminated character string that specifies the department name of the sender who initiated the fax transmission.

SenderBillingCode

Pointer to a constant null-terminated character string that indicates an application- or server-specific billing code that applies to the fax transmission. The fax server uses the string to generate an entry in the fax event log. Billing codes are optional.

DrProfileName

Pointer to a constant null-terminated character string that specifies the MAPI profile the fax server should use to send a delivery report (DR) or non-delivery report (NDR). This member must be NULL if you specify the DrEmailAddress member. For more information, see the following Remarks section.

DrEmailAddress

Pointer to a constant null-terminated character string that specifies the e-mail address in the global address list (GAL) to which the fax server should send the DR or NDR. This member must be NULL if you specify the DrProfileName member. For more information, see the following Remarks section.

OutputFileName

This member is reserved for future use by Microsoft. It must be set to NULL.

Remarks

A fax client application passes the FAX_PRINT_INFO structure in a call to the FaxStartPrintJob function to start a print job on a specified fax printer. For more information, see Printing a Fax to a Device Context.

You must specify a valid InboundProfile member in the FAX_CONFIGURATION structure before you specify a DrEmailAddress member or a DrProfileName member in the FAX_PRINT_INFO structure. For more information see Enabling MAPI Functionality in a Fax Client Application.

An application typically specifies the DrEmailAddress member instead of the DrProfileName member to use Microsoft Exchange Server technology.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable with BackOffice Small Business Server.
  Header: Declared in Winfax.h.
  Unicode: Declared as Unicode and ANSI structures.

See Also

Fax Service Client Application Programming Interface Overview, Fax Service Client API Structures, FaxStartPrintJob, FAX_CONFIGURATION