Compartir a través de

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

  • Artículo

Recupera datos adjuntos de un mensaje enviado por un host remoto.

Sintaxis

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

Parámetros

[out] pBuffer

Puntero a un búfer que recibe los datos leídos de la secuencia de datos adjuntos. El programa de aplicación es responsable de asignar y liberar este búfer de datos.

[in] dwBytesToRead

Tamaño del búfer de entrada de pBuffer , en bytes.

[out] pdwNumberOfBytesRead

Puntero a un DWORD que contiene el número de bytes de datos leídos del flujo de datos adjuntos en el búfer de entrada de pBuffer .

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes:

Código devuelto Descripción
S_OK
 El método se completó correctamente.
S_FALSE
 Se ha alcanzado el final de la secuencia de datos adjuntos.
E_INVALIDARG
 pBuffer es NULL.
E_POINTER
 pdwNumberofBytesRead es NULL.

Comentarios

El método Read permite a una aplicación recibir datos arbitrarios de un host remoto en datos adjuntos de mensajes encapsulados por MIME. WSDAPI proporcionará un objeto que implementa esta interfaz cuando se recibe una secuencia de datos adjuntos como parte de un mensaje. La llamada a Read abre la secuencia de datos adjuntos de entrada y transfiere los datos adjuntos al búfer de la aplicación. Si Read devuelve S_OK o S_FALSE, pdwNumberofBytesRead se establece en el número de bytes leídos, que puede ser menor que el tamaño del búfer. La llamada de lectura puede bloquearse en el tráfico de red.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wsdattachment.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDInboundAttachment