共用方式為

IWSDInboundAttachment：：Read 方法 (wsdattachment.h)

  • 發行項

從遠端主機所傳送的訊息擷取附件數據。

語法

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

參數

[out] pBuffer

接收從附件數據流讀取數據的緩衝區指標。 應用程式程式負責配置並釋放此數據緩衝區。

[in] dwBytesToRead

pBuffer 輸入緩衝區的大小，以位元組為單位。

[out] pdwNumberOfBytesRead

DWORD 的指標，其中包含從附件數據流讀取到 pBuffer 輸入緩衝區的數據位元組數目。

傳回值

可能的傳回值包括，但不限於下列各項：

傳回碼 描述
S_OK
 方法已順利完成。
S_FALSE
 已到達附件數據流的結尾。
E_INVALIDARG
 pBuffer 為 NULL。
E_POINTER
 pdwNumberofBytesRead 為 NULL。

備註

Read 方法可讓應用程式從 MIME 封裝訊息附件中的遠端主機接收任意數據。 WSDAPI 會在收到附件數據流做為訊息的一部分時，提供實作此介面的物件。 讀取的 呼叫會開啟 輸入附件數據流，並將附件數據傳送至應用程式的緩衝區。 如果 Read 傳回S_OK或 S_FALSE，pdwNumberofBytesRead 會設定為讀取的位元組數目，這可能小於緩衝區的大小。 讀取呼叫可能會封鎖網路流量。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wsdattachment.h (包含 Wsdapi.h)
Dll Wsdapi.dll

另請參閱

IWSDInboundAttachment