次の方法で共有

IByteBuffer::CopyTo メソッド

  • [アーティクル]

[ CopyTo メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 IStream インターフェイスも同様の機能を提供します。

CopyTo メソッドは、オブジェクト内の現在のシーク ポインターから別のオブジェクトの現在のシーク ポインターに、指定したバイト数をコピーします。

構文

HRESULT CopyTo(
  [in]  LPBYTEBUFFER *pByteBuffer,
  [in]  LONG         cb,
  [out] LONG         *pcbRead,
  [out] LONG         *pcbWritten
);

パラメーター

pByteBuffer [in]

宛先ストリームをポイントします。 pByteBuffer によって指されるストリームには、新しいストリームまたはソース ストリームの複製を指定できます。

cb [in]

ソース ストリームからコピーするバイト数。

pcbRead [out]

このメソッドがソースから読み取られた実際のバイト数を書き込む場所へのポインター。 このポインターを NULL に設定すると、この値に関心がないことを示すことができます。 この場合、このメソッドは読み取られた実際のバイト数を提供しません。

pcbWritten [out]

このメソッドが宛先に書き込まれた実際のバイト数を書き込む場所へのポインター。 このポインターを NULL に設定すると、この値に関心がないことを示すことができます。 この場合、このメソッドは書き込まれた実際のバイト数を提供しません。

戻り値

戻り値は HRESULT です。 S_OK の値は、呼び出しが成功したことを示します。

解説

このメソッドは、指定したバイトをあるストリームから別のストリームにコピーします。 ストリームをそれ自体にコピーするためにも使用できます。 各ストリーム インスタンスのシーク ポインターは、読み取りまたは書き込まれたバイト数に合わせて調整されます。

必要条件

要件 値
サポートされている最小のクライアント
 Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
クライアント サポートの終了
 Windows XP
サーバー サポートの終了
 Windows Server 2003
Header
Scardssp.h
タイプ ライブラリ
Scardssp.tlb
[DLL]
Scardssp.dll
IID
 IID_IByteBufferは E126F8FE-A7AF-11D0-B88A-00C04FD424B9 として定義されています