Функция WTSFreeMemoryExA (wtsapi32.h)
Освобождает память, содержащую 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 |
| целевая платформа | Виндоус |
| заголовка | wtsapi32.h |
| библиотеки |
Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| набор API | ext-ms-win-session-wtsapi32-l1-1-0 (представлено в Windows 8) |