Función WTSFreeMemoryExA (wtsapi32.h)

Artículo
11/20/2024

Libera memoria que contiene WTS_PROCESS_INFO_EX o estructuras de WTS_SESSION_INFO_1 asignadas por una función de Servicios de Escritorio remoto.

Sintaxis

BOOL WTSFreeMemoryExA(
  [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 se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7
servidor mínimo admitido	Windows Server 2008 R2
de la plataforma de destino de	Windows
encabezado de	wtsapi32.h
biblioteca de	Wtsapi32.lib
DLL de	Wtsapi32.dll
conjunto de API de	ext-ms-win-session-wtsapi32-l1-1-0 (introducido en Windows 8)