Fungsi LocalReAlloc (winbase.h)

Artikel
08/27/2023

Mengubah ukuran atau atribut objek memori lokal tertentu. Ukurannya bisa bertambah atau berkurang.

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

DECLSPEC_ALLOCATOR HLOCAL LocalReAlloc(
  [in] _Frees_ptr_opt_ HLOCAL hMem,
  [in] SIZE_T                 uBytes,
  [in] UINT                   uFlags
);

Parameter

[in] hMem

Handel ke objek memori lokal yang akan dialokasikan kembali. Handel ini dikembalikan oleh fungsi LocalAlloc atau LocalReAlloc .

[in] uBytes

Ukuran baru blok memori, dalam byte. Jika uFlags menentukan LMEM_MODIFY, parameter ini diabaikan.

[in] uFlags

Opsi realokasi. Jika LMEM_MODIFY ditentukan, fungsi memodifikasi atribut objek memori saja (parameter uBytes diabaikan.) Jika tidak, fungsi merealokasi objek memori.

Anda dapat secara opsional menggabungkan LMEM_MODIFY dengan nilai berikut.

Nilai	Makna
LMEM_MOVEABLE 0x0002	Mengalokasikan memori tetap atau dapat diubah. Jika memori adalah blok memori LMEM_MOVEABLE terkunci atau blok memori LMEM_FIXED dan bendera ini tidak ditentukan, memori hanya dapat direalokasikan di tempatnya.

Jika parameter ini tidak menentukan LMEM_MODIFY, Anda dapat menggunakan nilai berikut.

Nilai	Makna
LMEM_ZEROINIT 0x0040	Menyebabkan konten memori tambahan diinisialisasi ke nol jika objek memori tumbuh dalam ukuran.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke objek memori yang dialokasikan kembali.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika LocalReAlloc gagal, memori asli tidak dikosongkan, dan handel dan penunjuk asli masih valid.

Jika LocalReAlloc merealokasi objek tetap, nilai handel yang dikembalikan adalah alamat byte pertama dari blok memori. Untuk mengakses memori, proses cukup melemparkan nilai kembali ke penunjuk.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Fungsi Global dan Lokal

LocalAlloc

LocalFree

LocalLock

Fungsi Manajemen Memori

Bagikan melalui