IStream::Metode kloning (objidl.h)

  • Artikel

Metode Kloning membuat objek stream baru dengan penunjuk pencariannya sendiri yang mereferensikan byte yang sama dengan aliran asli.

Sintaks

HRESULT Clone(
  [out] IStream **ppstm
);

Parameter

[out] ppstm

Jika berhasil, arahkan ke lokasi penunjuk IStream ke objek stream baru. Jika terjadi kesalahan, parameter ini adalah NULL.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK Aliran berhasil dikloning.
E_PENDING Hanya Penyimpanan Asinkron: Sebagian atau semua data aliran saat ini tidak tersedia.
STG_E_INSUFFICIENTMEMORY Aliran tidak dikloning karena kurangnya memori.
STG_E_INVALIDPOINTER Penunjuk ppStm tidak valid.
STG_E_REVERTED Objek tidak valid oleh operasi kembali di atasnya di pohon transaksi.

Keterangan

Metode Kloning 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 dibagikan di 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.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header objidl.h
Pustaka Uuid.lib
DLL Ole32.dll

Lihat juga

IStream - Implementasi File Gabungan

IStream::CopyTo