FaxOutgoingJob.ExtendedStatus property

The ExtendedStatus property is a null-terminated string that describes the job's extended status.

This property is read-only.

Syntax

Property ExtendedStatus As String

Property value

A String that receives a description of the job's extended status. For more information, see FAX_JOB_EXTENDED_STATUS_ENUM.

Remarks

The ExtendedStatus property can have a value only if the fax service provider (FSP) returns a proprietary status code in the ExtendedStatusCode property. Otherwise, the ExtendedStatus property will contain an empty string. Similarly, an FSP may choose not to provide values for the ExtendedStatus property, and the property will thus contain an empty string. This is the case for the T.30 FSP provided with the fax service.

If an FSP provides a proprietary status code, the service loads the code string from the FSP, and passes both the string and the original status code to the client. If the FSP provides a status defined in FAX_JOB_EXTENDED_STATUS_ENUM, the service passes only the status code to the client.

A fax client application should check the extended status string first. If the string is not NULL/empty, it describes the extended status, and the extended status code is the same code that the FSP passed to the fax service. If the string is NULL/empty, the extended status code is one of those defined in FAX_JOB_EXTENDED_STATUS_ENUM.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
FaxComex.h
DLL
Fxscomex.dll

See also

Visual Basic Example

FaxOutgoingJob

IFaxOutgoingJob