IWSDInboundAttachment::Read メソッド (wsdattachment.h)
リモート ホストによって送信されたメッセージから添付ファイル データを取得します。
構文
HRESULT Read(
[out] BYTE *pBuffer,
[in] DWORD dwBytesToRead,
[out] LPDWORD pdwNumberOfBytesRead
);
パラメーター
[out] pBuffer
添付ファイル ストリームから読み取られたデータを受信するバッファーへのポインター。 アプリケーション・プログラムは、このデータ・バッファーの割り振りと解放を担当します。
[in] dwBytesToRead
pBuffer 入力バッファーのサイズ (バイト単位)。
[out] pdwNumberOfBytesRead
添付ファイル ストリームから pBuffer 入力バッファーに読み取られたデータのバイト数を含む DWORD へのポインター。
戻り値
可能な戻り値には、次のものが含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
メソッドが正常に完了しました。 |
|
添付ファイル ストリームの末尾に達しました。 |
|
pBuffer は NULL です。 |
|
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 |