Appendix 8: VBFax Constants

FaxPriorityConstants

FaxResolutionConstants

The preferred resolution at which the fax is to be transmitted, or the resolution of a received fax.

vbfResolutionCoarse (0) Low quality, but fast transmission time. This resolution is sometimes preferred for cost saving reasons when performing broadcast fax with low resolution text documents. This resolution is not appropriate for documents containing embedded graphics.

vbfResolutionFine (1) This is the most common resolution used for standard faxing of both text and graphics documents.

vbfResolutionSuperfine (2)This resolution is not available on all devices and is not yet widely supported by receiving fax machines. This resolution will provide superior results when sending graphics.

FaxStatusConstants

This enumeration is a standard list of status values used across both fax jobs and recipients. All Status methods in VBFax return this type.

vbfStatusNew (1) The job or recipient is new and has not been sent. All jobs or recipients which have not yet been sent will have this status.

vbfStatusScheduled (10)The job or recipient has been sent and now resides on the server.

vbfStatusPaused (11)The job or recipient resides on the fax server but has been placed in a paused condition where it will not be transmitted until resumed.

vbfStatusSending (12)The job or recipient is presently transmitting the fax to the specified destination.

vbfStatusReceiving (13)The specified job or recipient is presently being received.

vbfStatusDelivered (80)The output fax has been successfully delivered to its destination.

vbfStatusReceived (81)The inbound fax has been successfully received.

vbfStatusAborted (91)The application aborted sending or receiving of this fax.

vbfStatusFailed (92)Transmission of this fax has failed for some reason. Check the status property for more information.

FaxStatusReasonConstants

The FaxStatusReason provides additional information when a fax transmission fails.

vbfReasonNoError (0)This is the default reason when no error has been detected. If you check StatusReason when there is no error, this value will be returned.

vbfReasonNotDelivered (10)The fax server could not deliver the fax. No additional information is known about why.

vbfReasonBusy (11)The fax server could not deliver the fax because the destination was busy.

vbfReasonNoConnect (12)The fax server could not negotiate a connection with the receiving fax machine.

vbfReasonTimeout (13)Fax transmission timed out. The receiving fax machine took too long in acknowledging some phase of the operation.

vbfReasonDocFileNotFound (14)The document specified in the Documents collection of the job could not be found on the file system.

vbfReasonRemoteDocFileNotFound (15)The remote document named could not be found on the server's directory.

vbfReasonProtocolError (16)
vbfReasonInvalidInputGiven (17)
vbfReasonNoResponseGiven (18)
vbfReasonAbortedByHost (19)
vbfReasonBufferUnderflow (20)
vbfReasonHighSpeedImageNotCRFM (21)
vbfReasonBadLineQuality (22)
vbfReasonBadPage (23)
vbfReasonHDLCError (24)
vbfReasonNotInitialized (25)
vbfReasonUnexpectedError (26)

vbfReasonUnknown (99) Could not diagnose the reason for error.