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) |