Metode IByteBuffer::Clone

[Metode Kloning 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 Kloning membuat objek baru dengan penunjuk pencariannya sendiri yang mereferensikan byte yang sama dengan objek IByteBuffer asli.

Sintaks

HRESULT Clone(
  [out] LPBYTEBUFFER *ppByteBuffer
);

Parameter

ppByteBuffer [out]

Jika berhasil, arahkan ke lokasi penunjuk IByteBuffer ke objek stream baru. Setelah Anda selesai menggunakan penunjuk IByteBuffer , lepaskan dengan memanggil fungsi IUnknown::Release . Jika terjadi kesalahan, parameter ini adalah NULL.

Menampilkan nilai

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

Keterangan

Metode ini membuat objek stream baru untuk mengakses byte yang sama tetapi menggunakan penunjuk pencarian terpisah. Objek stream baru melihat data yang sama dengan objek aliran sumber. Perubahan yang ditulis ke satu objek segera terlihat di objek lainnya. Penguncian rentang dibagi antara objek stream.

Pengaturan awal penunjuk pencarian dalam instans aliran kloning sama dengan pengaturan penunjuk pencarian saat ini di aliran asli pada saat operasi kloning.

Contoh

Contoh berikut menunjukkan kloning antarmuka IByteBuffer .

HRESULT  hr;

// Clone the buffer.
hr = pIByteBuff->Clone(&pIByteClone);
if (FAILED(hr))
  printf("Failed IByteBuffer::Clone\n");

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