IInitializeWithStream::Initialize method (propsys.h)

Menginisialisasi handler dengan stream.

Sintaks

HRESULT Initialize(
  [in] IStream *pstream,
  [in] DWORD   grfMode
);

Parameter

[in] pstream

Jenis: IStream*

Penunjuk ke antarmuka IStream yang mewakili sumber aliran.

[in] grfMode

Jenis: DWORD

Salah satu nilai STGM berikut yang menunjukkan mode akses untuk pstream.

STGM_READ

Aliran yang ditunjukkan oleh pstream bersifat baca-saja.

STGM_READWRITE

Aliran yang ditunjukkan oleh pstream dapat diakses baca/tulis.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini lebih disukai untuk Menginisialisasi karena kemampuannya untuk menggunakan aliran yang tidak dapat diakses melalui jalur Win32, seperti konten file terkompresi dengan ekstensi nama file .zip.

Aliran yang diarahkan oleh pstream harus tetap terbuka selama masa pakai handler atau hingga IPropertyStore::Commit dipanggil.

Saat pertama kali dibuka, referensi aliran sumber menunjuk ke awal aliran. Handler dapat mencari dan membaca dari aliran kapan saja. Handler dapat diimplementasikan untuk membaca semua properti dari aliran selama Inisialisasi atau dapat menunggu hingga proses panggilan mencoba menghitung atau membaca properti sebelum mengambilnya dari aliran.

Instans handler harus diinisialisasi hanya sekali dalam masa pakainya. Upaya oleh pemanggil untuk menginisialisasi ulang handler akan mengakibatkan kesalahan HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	propsys.h