Función WTSFreeMemoryExW (wtsapi32.h)
Libera memoria que contiene estructuras WTS_PROCESS_INFO_EX o WTS_SESSION_INFO_1 asignadas por una función de Servicios de Escritorio remoto.
Sintaxis
BOOL WTSFreeMemoryExW(
[in] WTS_TYPE_CLASS WTSTypeClass,
[in] PVOID pMemory,
[in] ULONG NumberOfEntries
);
Parámetros
[in] WTSTypeClass
Valor del tipo de enumeración WTS_TYPE_CLASS que especifica el tipo de estructuras contenidas en el búfer al que hace referencia el parámetro pMemory .
[in] pMemory
Puntero al búfer que se va a liberar.
[in] NumberOfEntries
Número de elementos del búfer al que hace referencia el parámetro pMemory .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información ampliada de los errores, llame a la función GetLastError.
Observaciones
Varias funciones de Servicios de Escritorio remoto asignan búferes para devolver información. Para liberar búferes que contienen estructuras WTS_PROCESS_INFO_EX o WTS_SESSION_INFO_1 , debe llamar a la función WTSFreeMemoryEx . Para liberar otros búferes, puede llamar a la función WTSFreeMemory o a la función WTSFreeMemoryEx .
Nota
El encabezado wtsapi32.h define WTSFreeMemoryEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Plataforma de destino | Windows |
| Encabezado | wtsapi32.h |
| Library | Wtsapi32.lib |
| Archivo DLL | Wtsapi32.dll |
| Conjunto de API | ext-ms-win-session-wtsapi32-l1-1-0 (introducido en Windows 8) |