通过

IWSDInboundAttachment：：Read 方法 (wsdattachment.h)

  • 项目

从远程主机发送的邮件中检索附件数据。

语法

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

参数

[out] pBuffer

指向接收从附件流读取的数据的缓冲区的指针。 应用程序负责分配和释放此数据缓冲区。

[in] dwBytesToRead

pBuffer 输入缓冲区的大小（以字节为单位）。

[out] pdwNumberOfBytesRead

指向包含从附件流读取到 pBuffer 输入缓冲区的数据字节数的 DWORD 的指针。

返回值

可能的返回值包括但不限于以下内容：

返回代码 说明
S_OK
 方法已成功完成。
S_FALSE
 已到达附件流的末尾。
E_INVALIDARG
 pBuffer 为 NULL。
E_POINTER
 pdwNumberofBytesRead 为 NULL。

注解

Read 方法允许应用程序从 MIME 封装的消息附件中的远程主机接收任意数据。 当附件流作为消息的一部分收到时，WSDAPI 将提供实现此接口的对象。 对 Read 的调用会打开入站附件流，并将附件数据传输到应用程序的缓冲区。 如果 Read 返回S_OK或S_FALSE， 则 pdwNumberofBytesRead 设置为读取的字节数，这可能小于缓冲区的大小。 读取调用可能会阻止网络流量。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wsdattachment.h (包括 Wsdapi.h)
DLL Wsdapi.dll

另请参阅

IWSDInboundAttachment