Metode IByteBuffer::CopyTo

[Metode CopyTo tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini tidak tersedia untuk digunakan di Windows Server 2003 dengan Paket Layanan 1 (SP1) dan yang lebih baru, Windows Vista, Windows Server 2008, dan versi sistem operasi berikutnya. Antarmuka IStream menyediakan fungsionalitas serupa.]

Metode CopyTo menyalin jumlah byte tertentu dari penunjuk pencarian saat ini di objek ke penunjuk pencarian saat ini di objek lain.

Sintaks

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

Parameter

pByteBuffer [in]

Menunjuk ke aliran tujuan. Aliran yang diacu oleh pByteBuffer dapat menjadi aliran baru atau klon aliran sumber.

cb [in]

Jumlah byte yang akan disalin dari aliran sumber.

pcbRead [out]

Arahkan ke lokasi tempat metode ini menulis jumlah byte aktual yang dibaca dari sumbernya. Anda dapat mengatur penunjuk ini ke NULL untuk menunjukkan bahwa Anda tidak tertarik dengan nilai ini. Dalam hal ini, metode ini tidak memberikan jumlah byte aktual yang dibaca.

pcbWritten [out]

Arahkan ke lokasi tempat metode ini menulis jumlah byte aktual yang ditulis ke tujuan. Anda dapat mengatur penunjuk ini ke NULL untuk menunjukkan bahwa Anda tidak tertarik dengan nilai ini. Dalam hal ini, metode ini tidak memberikan jumlah byte aktual yang ditulis.

Menampilkan nilai

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan bahwa panggilan berhasil.

Keterangan

Metode ini menyalin byte yang ditentukan dari satu aliran ke aliran lainnya. Ini juga dapat digunakan untuk menyalin aliran ke dirinya sendiri. Penunjuk pencarian di setiap instans aliran disesuaikan untuk jumlah byte yang dibaca atau ditulis.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Akhir dukungan klien	Windows XP
Akhir dukungan server	Windows Server 2003
Header	Scardssp.h
Pustaka jenis	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer didefinisikan sebagai E126F8FE-A7AF-11D0-B88A-00C04FD424B9