Funzione WTSFreeMemoryExA (wtsapi32.h)

Articolo
08/28/2023

Libera la memoria che contiene WTS_PROCESS_INFO_EX o strutture WTS_SESSION_INFO_1 allocate da una funzione di Servizi Desktop remoto.

Sintassi

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

Parametri

[in] WTSTypeClass

Valore del tipo di enumerazione WTS_TYPE_CLASS che specifica il tipo di strutture contenute nel buffer a cui fa riferimento il parametro pMemory .

[in] pMemory

Puntatore al buffer da liberare.

[in] NumberOfEntries

Numero di elementi nel buffer a cui fa riferimento il parametro pMemory .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

Diverse funzioni di Servizi Desktop remoto allocano buffer per restituire informazioni. Per liberare buffer contenenti strutture WTS_PROCESS_INFO_EX o WTS_SESSION_INFO_1 , è necessario chiamare la funzione WTSFreeMemoryEx . Per liberare altri buffer, è possibile chiamare la funzione WTSFreeMemory o la funzione WTSFreeMemoryEx .

Nota

L'intestazione wtsapi32.h definisce WTSFreeMemoryEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll
Set di API	ext-ms-win-session-wtsapi32-l1-1-0 (introdotto in Windows 8)