Fungsi LocalFlags (winbase.h)

Artikel
01/10/2024

Mengambil informasi tentang objek memori lokal 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

UINT LocalFlags(
  [in] HLOCAL hMem
);

Parameter

[in] hMem

Handel ke objek memori lokal. Handel ini dikembalikan oleh fungsi LocalAlloc atau LocalReAlloc .

Nilai kembali

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

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

Keterangan

Byte urutan rendah dari kata berurutan rendah dari nilai yang dikembalikan berisi jumlah kunci objek. Untuk mengambil jumlah kunci dari nilai yang dikembalikan, gunakan masker LMEM_LOCKCOUNT dengan operator bitwise AND (&). Jumlah kunci objek memori yang dialokasikan dengan LMEM_FIXED selalu nol.

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

Fungsi lokal 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 lokal 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