Platform SDK: Fax Services

FAX_JOB_PARAM

The FAX_JOB_PARAM structure contains the information necessary for the fax server to send an individual fax transmission. The structure includes the recipient's fax number, sender and recipient data, an optional billing code, and job scheduling information.

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

typedef struct _FAX_JOB_PARAM {
  DWORD       SizeOfStruct;        //structure size, in bytes
  LPCTSTR     RecipientNumber;     //pointer to recipient's fax number
  LPCTSTR     RecipientName;       //pointer to recipient's name
  LPCTSTR     Tsid;                //pointer to transmitting station identifier
  LPCTSTR     SenderName;          //pointer to sender's name
  LPCTSTR     SenderCompany        //pointer to sender's company
  LPCTSTR     SenderDept;          //pointer to sender's department
  LPCTSTR     BillingCode;         //pointer to billing code
  DWORD       ScheduleAction;      //job scheduling action code
  SYSTEMTIME  ScheduleTime;        //time to send fax
  DWORD       DeliveryReportType;  //e-mail delivery report type
  LPCTSTR     DeliveryReportAddress; 
                                   //pointer to e-mail address
  LPCTSTR     DocumentName;        //pointer to document name to display
  HCALL       CallHandle;          //optional TAPI call handle
  DWORD       Reserved[3];         //must be zero
} FAX_JOB_PARAM, *PFAX_JOB_PARAM; 

Members

SizeOfStruct
Specifies the size, in bytes, of the FAX_JOB_PARAM structure. The calling application must set this member to sizeof(FAX_JOB_PARAM). This member is required.
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 unless you specify a valid TAPI CallHandle member.
RecipientName
Pointer to a constant null-terminated character string that specifies the name of the recipient of the fax transmission.
Tsid
Pointer to a constant null-terminated character string that specifies the transmitting station identifier. This identifier is usually a telephone number.
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.
BillingCode
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.
ScheduleAction
Specifies a DWORD variable that indicates when to send the fax. This member is required, and can be one of the following predefined job scheduling actions.
Value Meaning
JSA_NOW Send the fax as soon as a device is available.
JSA_SPECIFIC_TIME Send the fax at the time specified by the ScheduleTime member.
JSA_DISCOUNT_PERIOD Send the fax during the discount rate period. Call the FaxGetConfiguration function to retrieve the discount period for the fax server.

ScheduleTime
If the ScheduleAction member is equal to the value JSA_SPECIFIC_TIME, specifies a SYSTEMTIME structure that contains the date and time to send the fax. The time specified must be expressed in Coordinated Universal Time (UTC).
DeliveryReportType
Specifies a DWORD variable that indicates the type of e-mail DR or NDR that the fax server should generate. This member can be one of the following predefined delivery report types.
Value Meaning
DRT_NONE Do not send a DR or an NDR to the sender of the fax transmission.
DRT_EMAIL Send the DR or NDR in an e-mail message to the sender of the fax transmission.
DRT_INBOX Send the DR or NDR in e-mail to the sender's local personal information store.

DeliveryReportAddress
Pointer to a constant null-terminated character string. If the DeliveryReportType member is equal to DRT_EMAIL, the string is the address to which the DR or NDR should be sent. If the DeliveryReportType member is equal to DRT_INBOX, the string is the MAPI profile to which the DR or NDR should be sent. If the DeliveryReportType member is equal to DRT_NONE, this member must be NULL.
DocumentName
Pointer to a constant null-terminated character string to associate with the fax document. This is the user-friendly name that appears in the print spooler.
CallHandle
Specifies an optional call handle returned by the TAPI 2.x lineMakeCall function. If you specify a valid call handle, you can transmit a fax document to an active call in a cost-effective manner.
Reserved[3]
This member is reserved for future use by Microsoft. It must be set to zero.

Remarks

A fax client application passes the FAX_JOB_PARAM structure in a call to the FaxSendDocument function to inform the fax server how and when to send the fax transmission. For more information, see Sending a Fax to One Recipient.

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, FaxSendDocument, SYSTEMTIME, FaxCompleteJobParams, FaxGetConfiguration, lineMakeCall