WTSFreeMemoryExA, fonction (wtsapi32.h)
Libère de la mémoire qui contient des structures WTS_PROCESS_INFO_EX ou WTS_SESSION_INFO_1 allouées par une fonction 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 à libérer.
[in] NumberOfEntries
Nombre d’éléments dans la mémoire tampon référencée par le paramètre pMemory.
Valeur de retour
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’erreur étendues, 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
Note
L’en-tête wtsapi32.h définit WTSFreeMemoryEx comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 |
| serveur minimum pris en charge | Windows Server 2008 R2 |
| plateforme cible | Windows |
| d’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) |