Fungsi LocalSize (winbase.h)

Artikel
03/13/2024

Mengambil ukuran objek memori lokal yang ditentukan saat ini, dalam byte.

Catatan 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.

Sintaks

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

Parameter

[in] hMem

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

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ukuran objek memori lokal yang ditentukan, dalam byte. Jika handel yang ditentukan tidak valid atau jika objek telah dibuang, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Ukuran blok memori mungkin lebih besar dari ukuran yang diminta ketika memori dialokasikan.

Untuk memverifikasi bahwa blok memori objek yang ditentukan belum dibuang, panggil fungsi LocalFlags sebelum memanggil LocalSize.

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