Metode IInitializeWithItem::Initialize (shobjidl_core.h)

Menginisialisasi handler dengan IShellItem.

Sintaks

HRESULT Initialize(
  [in] IShellItem *psi,
  [in] DWORD      grfMode
);

Parameter

[in] psi

Jenis: IShellItem*

Penunjuk ke IShellItem.

[in] grfMode

Jenis: DWORD

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

STGM_READ

IShellItem bersifat baca-saja.

STGM_READWRITE

IShellItem dapat diakses baca/tulis.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Jika IShellItem tidak dapat diakses, metode ini mengembalikan kode kesalahan yang sesuai.

Instans handler harus diinisialisasi hanya sekali dalam masa pakainya. Upaya oleh aplikasi panggilan untuk menginisialisasi ulang handler 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	shobjidl_core.h (termasuk Propsys.h)