Funzione WTSFreeMemoryExW (wtsapi32.h)

Articolo
11/20/2024

Libera memoria contenente strutture WTS_PROCESS_INFO_EX o WTS_SESSION_INFO_1 allocate da una funzione di Servizi Desktop remoto.

Sintassi

BOOL WTSFreeMemoryExW(
  [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 estese sull'errore, chiamare la funzione GetLastError .

Osservazioni

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 oppure 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7
server minimo supportato	Windows Server 2008 R2
piattaforma di destinazione	Finestre
intestazione	wtsapi32.h
libreria	Wtsapi32.lib
dll	Wtsapi32.dll
set di API	ext-ms-win-session-wtsapi32-l1-1-0 (introdotto in Windows 8)