Fungsi GlobalFlags (winbase.h)

Artikel
03/03/2024

Mengambil informasi tentang objek memori global yang ditentukan.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi baru harus menggunakan fungsi heap. Untuk informasi selengkapnya, lihat Keterangan.

Sintaks

C++

UINT GlobalFlags(
  [in] HGLOBAL hMem
);

Parameter

[in] hMem

Handel ke objek memori global. Handel ini dikembalikan oleh fungsi GlobalAlloc atau GlobalReAlloc .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan menentukan nilai alokasi dan jumlah kunci untuk objek memori.

Jika fungsi gagal, nilai yang dikembalikan GMEM_INVALID_HANDLE, menunjukkan bahwa handel global tidak valid. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Byte urutan rendah dari kata urutan rendah dari nilai yang dikembalikan berisi jumlah kunci objek. Untuk mengambil jumlah kunci dari nilai pengembalian, gunakan GMEM_LOCKCOUNT mask dengan operator bitwise AND (&). Jumlah kunci objek memori yang dialokasikan dengan GMEM_FIXED selalu nol.

Byte urutan tinggi dari kata berurutan rendah dari nilai yang dikembalikan menunjukkan nilai alokasi objek memori. Bisa nol atau GMEM_DISCARDED.

Fungsi global memiliki overhead yang lebih besar dan menyediakan lebih sedikit fitur daripada fungsi manajemen memori lainnya. Aplikasi baru harus menggunakan fungsi heap kecuali dokumentasi menyatakan bahwa fungsi global harus digunakan. Untuk informasi selengkapnya, lihat Fungsi Global dan Lokal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll