FAX_PRINT_INFOW structure (winfax.h)

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.

Syntax

typedef struct _FAX_PRINT_INFOW {
  DWORD   SizeOfStruct;
  LPCWSTR DocName;
  LPCWSTR RecipientName;
  LPCWSTR RecipientNumber;
  LPCWSTR SenderName;
  LPCWSTR SenderCompany;
  LPCWSTR SenderDept;
  LPCWSTR SenderBillingCode;
  LPCWSTR Reserved;
  LPCWSTR DrEmailAddress;
  LPCWSTR OutputFileName;
} FAX_PRINT_INFOW, *PFAX_PRINT_INFOW;

Members

SizeOfStruct

Type: DWORD

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

Type: LPCTSTR

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

RecipientName

Type: LPCTSTR

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

RecipientNumber

Type: LPCTSTR

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

Type: LPCTSTR

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

SenderCompany

Type: LPCTSTR

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

SenderDept

Type: LPCTSTR

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

SenderBillingCode

Type: LPCTSTR

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.

Reserved

Type: LPCTSTR

Reserved. Must be set to NULL.

DrEmailAddress

Type: LPCTSTR

Pointer to a constant null-terminated character string that specifies the email address to which the fax server should send the delivery report (DR) or nondelivery report (NDR).

OutputFileName

Type: LPCTSTR

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.

Note

The winfax.h header defines FAX_PRINT_INFO as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	winfax.h

See also

FAX_CONFIGURATION

Fax Service Client API Structures

Fax Service Client API for Windows 2000

FaxStartPrintJob