Fungsi GetHGlobalFromILockBytes (coml2api.h)

Fungsi GetHGlobalFromILockBytes mengambil handel memori global ke objek array byte yang dibuat menggunakan fungsi CreateILockBytesOnHGlobal .

Sintaks

HRESULT GetHGlobalFromILockBytes(
  [in]  LPLOCKBYTES plkbyt,
  [out] HGLOBAL     *phglobal
);

Parameter

[in] plkbyt

Penunjuk ke antarmuka ILockBytes pada objek byte-array yang sebelumnya dibuat oleh panggilan ke fungsi CreateILockBytesOnHGlobal .

[out] phglobal

Penunjuk ke handel memori saat ini yang digunakan oleh objek byte-array yang ditentukan.

Nilai kembali

Fungsi ini mengembalikan HRESULT.

Keterangan

Setelah panggilan ke CreateILockBytesOnHGlobal, yang membuat objek array byte pada memori global, GetHGlobalFromILockBytes mengambil penunjuk ke handel memori global yang mendasari objek array byte. Menangani pengembalian fungsi ini mungkin berbeda dari handel asli karena panggilan intervensi ke fungsi GlobalReAlloc .

Konten handel memori yang dikembalikan dapat ditulis ke file disk bersih, lalu dibuka sebagai objek penyimpanan menggunakan fungsi StgOpenStorage .

Fungsi ini hanya berfungsi dalam proses yang sama dari mana array byte dibuat.

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	coml2api.h (termasuk Ole2.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

CreateiLockBytesOnhglobal

StgOpenStorage