FAX_JOB_PARAMA structure (winfax.h)
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.
Syntax
typedef struct _FAX_JOB_PARAMA {
DWORD SizeOfStruct;
LPCSTR RecipientNumber;
LPCSTR RecipientName;
LPCSTR Tsid;
LPCSTR SenderName;
LPCSTR SenderCompany;
LPCSTR SenderDept;
LPCSTR BillingCode;
DWORD ScheduleAction;
SYSTEMTIME ScheduleTime;
DWORD DeliveryReportType;
LPCSTR DeliveryReportAddress;
LPCSTR DocumentName;
HCALL CallHandle;
DWORD_PTR Reserved[3];
} FAX_JOB_PARAMA, *PFAX_JOB_PARAMA;
Members
SizeOfStruct
Type: DWORD
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
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.
RecipientName
Type: LPCTSTR
Pointer to a constant null-terminated character string that specifies the name of the recipient of the fax transmission.
Tsid
Type: LPCTSTR
Pointer to a constant null-terminated character string that specifies the transmitting station identifier (TSID). This identifier is usually a telephone number. Only printable characters such as English letters, numeric symbols, and punctuation marks (ASCII range 0x20 to 0x7F) can be used in a TSID.
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.
BillingCode
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.
ScheduleAction
Type: DWORD
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.
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
Type: SYSTEMTIME
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 UTC.
DeliveryReportType
Type: DWORD
Specifies a DWORD variable that indicates the type of email delivery report (DR) or nondelivery report (NDR) that the fax server should generate. This member can be one of the following predefined delivery report types.
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 email message to the sender of the fax transmission (supported in Windows Server 2003 and later).
DRT_INBOX
Send the DR or NDR in email to the sender's local personal information store.
DeliveryReportAddress
Type: LPCTSTR
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_NONE, this member must be NULL.
DocumentName
Type: LPCTSTR
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
Type: HCALL
Reserved, and should be NULL.
Reserved[3]
Type: DWORD_PTR[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 (Win32 Environment).
Note
The winfax.h header defines FAX_JOB_PARAM as an alias that 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 is 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 Service Client API Structures