Функция WTSFreeMemoryExA (wtsapi32.h)

Статья
08/28/2023

Освобождает память, содержащую WTS_PROCESS_INFO_EX или WTS_SESSION_INFO_1 структуры, выделенные функцией служб удаленных рабочих столов.

Синтаксис

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

Параметры

[in] WTSTypeClass

Значение типа перечисления WTS_TYPE_CLASS , указывающее тип структур, содержащихся в буфере, на который ссылается параметр pMemory .

[in] pMemory

Указатель на буфер для освобождения.

[in] NumberOfEntries

Количество элементов в буфере, на которые ссылается параметр pMemory .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Несколько функций служб удаленных рабочих столов выделяют буферы для возврата сведений. Чтобы освободить буферы, содержащие WTS_PROCESS_INFO_EX или WTS_SESSION_INFO_1 структуры, необходимо вызвать функцию WTSFreeMemoryEx . Чтобы освободить другие буферы, можно вызвать функцию WTSFreeMemory или WTSFreeMemoryEx .

Примечание

Заголовок wtsapi32.h определяет WTSFreeMemoryEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 7
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Windows
Header	wtsapi32.h
Библиотека	Wtsapi32.lib
DLL	Wtsapi32.dll
Набор API	ext-ms-win-session-wtsapi32-l1-1-0 (появилась в Windows 8)