Compartilhar via

Método IWSDInboundAttachment::Read (wsdattachment.h)

  • Artigo

Recupera dados de anexo de uma mensagem enviada por um host remoto.

Sintaxe

HRESULT Read(
  [out] BYTE    *pBuffer,
  [in]  DWORD   dwBytesToRead,
  [out] LPDWORD pdwNumberOfBytesRead
);

Parâmetros

[out] pBuffer

Ponteiro para um buffer que recebe os dados lidos do fluxo de anexos. O programa de aplicativo é responsável por alocar e liberar esse buffer de dados.

[in] dwBytesToRead

Tamanho do buffer de entrada do pBuffer , em bytes.

[out] pdwNumberOfBytesRead

Ponteiro para um DWORD que contém o número de bytes de dados lidos do fluxo de anexos no buffer de entrada do pBuffer .

Retornar valor

Os valores retornados possíveis incluem, mas não se limitam a:

Código de retorno Descrição
S_OK
 Método concluído com êxito.
S_FALSE
 O final do fluxo de anexos foi atingido.
E_INVALIDARG
 pBuffer é NULL.
E_POINTER
 pdwNumberofBytesRead é NULL.

Comentários

O método Read permite que um aplicativo receba dados arbitrários de um host remoto em um anexo de mensagem encapsulado por MIME. O WSDAPI fornecerá um objeto que implementa essa interface quando um fluxo de anexos é recebido como parte de uma mensagem. A chamada para Ler abre o fluxo de anexos de entrada e transfere os dados do anexo para o buffer do aplicativo. Se Read retornar S_OK ou S_FALSE, pdwNumberofBytesRead será definido como o número de bytes lidos, que pode ser menor que o tamanho do buffer. A chamada de Leitura pode bloquear o tráfego de rede.

Requisitos

Requisito Valor
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 wsdattachment.h (include Wsdapi.h)
DLL Wsdapi.dll

Confira também

IWSDInboundAttachment