Método IFaxDocument::ConnectedSubmit (faxcomex.h)

  • Artigo

O método IFaxDocument::ConnectedSubmit envia um único documento de fax para o IFaxServer conectado. O método retorna uma matriz de cadeias de caracteres de ID do trabalho de fax, uma para cada destinatário do fax.

Sintaxe

HRESULT ConnectedSubmit(
  [in]          IFaxServer *pFaxServer,
  [out, retval] VARIANT    *pvFaxOutgoingJobIDs
);

Parâmetros

[in] pFaxServer

Tipo: IFaxServer*

Uma interface IFaxServer que especifica um servidor de fax conectado.

[out, retval] pvFaxOutgoingJobIDs

Tipo: VARIANT*

VARIANT que contém uma matriz de cadeias de caracteres de ID 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

Nota Para ter êxito, o método IFaxDocument::ConnectedSubmit exige que o objeto 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 do IFaxDocument::get_Priority 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

Confira também

IFaxDocument

Exemplo do Visual Basic