Bagikan melalui

Metode IHostMemoryManager::VirtualFree

Berfungsi sebagai pembungkus logis untuk fungsi Win32 yang sesuai. Implementasi Win32 dari rilis VirtualFree, decommits, atau rilis dan decommits wilayah halaman dalam ruang alamat virtual dari proses panggilan.

Sintaks

HRESULT VirtualFree (  
    [in] LPVOID  lpAddress,  
    [in] SIZE_T  dwSize,  
    [in] DWORD   dwFreeType  
);

Parameter

lpAddress
[in] Penunjuk ke alamat dasar halaman memori virtual yang akan dibebaskan.

dwSize
[in] Ukuran, dalam byte, dari wilayah yang akan dikosongkan.

dwFreeType
[in] Jenis operasi pengosongan.

Tampilkan Nilai

HRESULT Deskripsi
S_OK VirtualFree berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam status yang tidak dapat menjalankan kode terkelola atau tidak berhasil memproses panggilan.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION Upaya dilakukan untuk mengosongkan memori yang tidak dialokasikan melalui host.

Keterangan

VirtualFree mengosongkan halaman memori virtual yang terkait dengan parameter lpAddress melalui panggilan sebelumnya ke fungsi IHostMemoryManager::VirtualAlloc. Upaya untuk mengosongkan memori yang tidak dialokasikan melalui host harus mengembalikan HOST_E_INVALIDOPERATION.

Semantik identik dengan implementasi Win32 dari VirtualFree. Untuk informasi selengkapnya, lihat dokumentasi Platform Windows.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on