Функция 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 |
Целевая платформа | Windows |
Header | wtsapi32.h |
Библиотека | Wtsapi32.lib |
DLL | Wtsapi32.dll |
Набор API | ext-ms-win-session-wtsapi32-l1-1-0 (появилась в Windows 8) |