LsaFreeMemory, fonction (ntsecapi.h)

La fonction LsaFreeMemory libère la mémoire allouée pour une mémoire tampon de sortie par un appel de fonction LSA. Les fonctions LSA qui retournent des mémoires tampons de sortie de longueur variable allouent toujours la mémoire tampon pour le compte de l’appelant. L’appelant doit libérer cette mémoire en passant le pointeur de mémoire tampon retourné à LsaFreeMemory lorsque la mémoire n’est plus nécessaire.

Syntaxe

NTSTATUS LsaFreeMemory(
  [in] PVOID Buffer
);

Paramètres

[in] Buffer

Pointeur vers la mémoire tampon allouée par un appel de fonction LSA. Si LsaFreeMemory réussit, cette mémoire tampon est libérée.

Valeur retournée

Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.

Si la fonction échoue, la valeur de retour est un code NTSTATUS, qui peut être la valeur suivante ou l’une des valeurs de retour de la fonction de stratégie LSA.

Code de retour Description
STATUS_UNSUCCESSFUL
Impossible de libérer la mémoire, car elle n’a pas été allouée par un appel de fonction LSA.
 

Vous pouvez utiliser la fonction LsaNtStatusToWinError pour convertir le code NTSTATUS en code d’erreur Windows.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntsecapi.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

Valeurs de retour de la fonction de stratégie LSA

LsaNtStatusToWinError