Partager via


WTSFreeMemoryExA, fonction (wtsapi32.h)

Libère la mémoire qui contient des structures WTS_PROCESS_INFO_EX ou WTS_SESSION_INFO_1 allouées par une fonction des services Bureau à distance.

Syntaxe

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

Paramètres

[in] WTSTypeClass

Valeur du type d’énumération WTS_TYPE_CLASS qui spécifie le type de structures contenues dans la mémoire tampon référencée par le paramètre pMemory .

[in] pMemory

Pointeur vers la mémoire tampon pour libérer.

[in] NumberOfEntries

Nombre d’éléments dans la mémoire tampon référencés par le paramètre pMemory .

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Remarques

Plusieurs fonctions des services Bureau à distance allouent des mémoires tampons pour retourner des informations. Pour libérer des mémoires tampons qui contiennent des structures WTS_PROCESS_INFO_EX ou WTS_SESSION_INFO_1 , vous devez appeler la fonction WTSFreeMemoryEx . Pour libérer d’autres mémoires tampons, vous pouvez appeler la fonction WTSFreeMemory ou la fonction WTSFreeMemoryEx .

Notes

L’en-tête wtsapi32.h définit WTSFreeMemoryEx comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications

   
Client minimal pris en charge Windows 7
Serveur minimal pris en charge Windows Server 2008 R2
Plateforme cible Windows
En-tête wtsapi32.h
Bibliothèque Wtsapi32.lib
DLL Wtsapi32.dll
Ensemble d’API ext-ms-win-session-wtsapi32-l1-1-0 (introduit dans Windows 8)

Voir aussi

WTSEnumerateProcesses

WTSEnumerateProcessesEx

WTSEnumerateSessions

WTSFreeMemory

WTSQuerySessionInformation

WTSQueryUserConfig

WTS_PROCESS_INFO_EX

WTS_SESSION_INFO_1