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 |
|
DLL |
|
See also