Fungsi WTSFreeMemoryExA (wtsapi32.h)

Artikel
08/28/2023

Membebaskan memori yang berisi struktur WTS_PROCESS_INFO_EX atau WTS_SESSION_INFO_1 yang dialokasikan oleh fungsi Layanan Desktop Jauh.

Sintaks

BOOL WTSFreeMemoryExA(
  [in] WTS_TYPE_CLASS WTSTypeClass,
  [in] PVOID          pMemory,
  [in] ULONG          NumberOfEntries
);

Parameter

[in] WTSTypeClass

Nilai jenis enumerasi WTS_TYPE_CLASS yang menentukan jenis struktur yang terkandung dalam buffer yang direferensikan oleh parameter pMemory .

[in] pMemory

Penunjuk ke buffer untuk membebaskan.

[in] NumberOfEntries

Jumlah elemen dalam buffer yang dirujuk oleh parameter pMemory .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Keterangan

Beberapa fungsi Layanan Desktop Jarak Jauh mengalokasikan buffer untuk mengembalikan informasi. Untuk membebaskan buffer yang berisi struktur WTS_PROCESS_INFO_EX atau WTS_SESSION_INFO_1 , Anda harus memanggil fungsi WTSFreeMemoryEx . Untuk membebaskan buffer lain, Anda dapat memanggil fungsi WTSFreeMemory atau fungsi WTSFreeMemoryEx .

Catatan

Header wtsapi32.h mendefinisikan WTSFreeMemoryEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	wtsapi32.h
Pustaka	Wtsapi32.lib
DLL	Wtsapi32.dll
Set API	ext-ms-win-session-wtsapi32-l1-1-0 (diperkenalkan di Windows 8)