Método IFaxDocument2::ConnectedSubmit2 (faxcomex.h)

  • Artigo

Envia um ou mais documentos de fax para o FaxServer conectado. Esse método retorna uma matriz de cadeias de caracteres de ID do trabalho de fax, uma para cada destinatário do fax.

Nota Esse método tem suporte apenas no Windows Vista e posterior.
 

Sintaxe

HRESULT ConnectedSubmit2(
  [in]          IFaxServer *pFaxServer,
  [out]         VARIANT    *pvFaxOutgoingJobIDs,
  [out, retval] long       *plErrorBodyFile
);

Parâmetros

[in] pFaxServer

Tipo: IFaxServer*

Um objeto FaxServer que especifica um servidor de fax conectado.

[out] pvFaxOutgoingJobIDs

Tipo: VARIANT*

Uma VARIANT que contém uma matriz de cadeias de caracteres de ID de trabalho de saída, uma para cada destinatário do fax.

[out, retval] plErrorBodyFile

Tipo: LONG*

Um LONG que representa a posição baseada em zero do arquivo enviado que causou a falha da operação de envio de fax. Consulte Observações.

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

Nota Para ter êxito, o método IFaxDocument2::ConnectedSubmit2 exige que o fax tenha pelo menos um destinatário e uma folha de rosto 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.
 
Você deve definir a propriedade IFaxDocument2::Bodies com uma lista delimitada por ponto e vírgula dos arquivos a serem enviados por fax antes de chamar IFaxDocument2::ConnectedSubmit2.
Nota A propriedade Body deve ser NULL para usar IFaxDocument2::ConnectedSubmit2.
 
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 acesso far2SUBMIT_LOW, far2SUBMIT_NORMAL ou far2SUBMIT_HIGH definido corretamente, dependendo da Prioridade do documento de fax.

Para ilustrar plErrorBodyFile, aqui está um exemplo: A seguinte lista de arquivos é enviada como o valor de IFaxDocument2::Bodies:

"MyTextFile.txt;AnotherTextFile.txt;MyPDFfile.pdf;MyWordFile.doc".

Como não há suporte para a extensão "*.pdf", a operação de envio falhará e plErrorBodyFile retornará como 2.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho faxcomex.h
DLL Fxscomex.dll

Confira também

FaxDocument

IFaxDocument2