Funzione WTSFreeMemoryExA (wtsapi32.h)
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) |