IFaxDocument::Submit method (faxcomex.h)
The IFaxDocument::Submit method submits a single fax document to the fax service for processing.
Syntax
HRESULT Submit(
[in] BSTR bstrFaxServerName,
VARIANT *pvFaxOutgoingJobIDs
);
Parameters
[in] bstrFaxServerName
Type: BSTR
BSTR that specifies a fax server. If this parameter is NULL or an empty string, the local fax server is specified.
pvFaxOutgoingJobIDs
Type: VARIANT*
VARIANT that specifies a collection of outbound job IDs, one for each recipient of the fax.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
You must provide the server name when submitting the document. To submit the document to the local server, set the bstrFaxServerName parameter to NULL or an empty string. The method returns a collection of fax job IDs, one for each recipient of the fax.
To succeed, the IFaxDocument::Submit method requires that the IFaxDocument interface 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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | faxcomex.h |
| DLL | Fxscomex.dll |