Método IFaxDocument::Submit (faxcomex.h)
O método IFaxDocument::Submit envia um único documento de fax para o serviço de fax para processamento.
Sintaxe
HRESULT Submit(
[in] BSTR bstrFaxServerName,
VARIANT *pvFaxOutgoingJobIDs
);
Parâmetros
[in] bstrFaxServerName
Tipo: BSTR
BSTR que especifica um servidor de fax. Se esse parâmetro for NULL ou uma cadeia de caracteres vazia, o servidor de fax local será especificado.
pvFaxOutgoingJobIDs
Tipo: VARIANT*
VARIANT que especifica uma coleção de IDs de trabalho de saída, uma para cada destinatário do fax.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Você deve fornecer o nome do servidor ao enviar o documento. Para enviar o documento para o servidor local, defina o parâmetro bstrFaxServerName como NULL ou uma cadeia de caracteres vazia. O método retorna uma coleção de IDs de trabalho de fax, uma para cada destinatário do fax.
Para ter êxito, o método IFaxDocument::Submit requer que a interface IFaxDocument tenha pelo menos um destinatário e uma página de capa ou um corpo de fax. Você só poderá usar esse método se o servidor (remoto ou local) estiver instalado como uma impressora de rede no computador local.
Esse método não tem suporte para uma conexão remota com um servidor de fax que executa o Windows XP Home Edition ou o Windows XP Professional e retornará o erro FAX_E_NOT_SUPPORTED_ON_THIS_SKU.
Para usar esse método, um usuário deve ter o direito de acesso farSUBMIT_LOW, farSUBMIT_NORMAL ou farSUBMIT_HIGH , dependendo da Prioridade do documento de fax.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | faxcomex.h |
| DLL | Fxscomex.dll |