FaxDocument.ConnectedSubmit method

The ConnectedSubmit method submits a single fax document to the connected FaxServer. The method returns an array of fax job ID strings, one for each recipient of the fax.

Syntax

FaxDocument.ConnectedSubmit( _
  ByVal FaxServer As FaxServer _
) As Variant

Parameters

FaxServer [in]

Type: FaxServer*

A FaxServer object that specifies a connected fax server.

Return value

Type: Variant*

Variant that holds an array of outbound job ID strings, one for each recipient of the fax.

Remarks

Note

To succeed, the ConnectedSubmit method requires that the FaxDocument object have at least one recipient, and either a cover page or a fax body. You can only use this method if the server (remote or local) is installed as a network printer on the local computer.

 

This method is not supported for a remote connection to a fax server running Windows XP Home Edition or Windows XP Professional, and will return the error: FAX_E_NOT_SUPPORTED_ON_THIS_SKU.

To use this method, a user must have the farSUBMIT_LOW, farSUBMIT_NORMAL, or farSUBMIT_HIGH access right, depending on the Priority of the fax document.

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

FaxDocument

IFaxDocument