IInitializeWithFile::Initialize method (propsys.h)

Artikel
03/01/2024

Menginisialisasi handler dengan jalur file.

Sintaks

HRESULT Initialize(
  [in] LPCWSTR pszFilePath,
  [in] DWORD   grfMode
);

Parameter

[in] pszFilePath

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi jalur file sebagai string Unicode yang dihentikan null.

[in] grfMode

Jenis: DWORD

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

STGM_READ

File yang ditunjukkan oleh IInitializeWithFile::Initialize bersifat baca-saja.

STGM_READWRITE

File yang ditunjukkan oleh IInitializeWithFile::Initialize dapat dibaca dan ditulis.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Inisialisasi lebih disukai untuk metode ini karena kemampuannya untuk menggunakan file yang tidak dapat diakses melalui jalur Win32, seperti konten file terkompresi dengan ekstensi nama file .zip. Gunakan IInitializeWithFile::Initialize hanya ketika API yang digunakan oleh handler untuk mengakses file hanya menerima jalur file.

File yang ditunjukkan oleh pszFilePath harus tetap terbuka selama masa pakai handler atau sampai IPropertyStore::Commit dipanggil.

Jika file tidak dapat dibuka sesuai dengan nilai parameter metode, metode ini mengembalikan kode kesalahan yang sesuai.

Instans handler harus diinisialisasi hanya sekali dalam masa pakainya. Upaya oleh aplikasi panggilan 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

Bagikan melalui