Funzione LsaFreeMemory (ntsecapi.h)

  • Articolo

La funzione LsaFreeMemory libera memoria allocata per un buffer di output da una chiamata di funzione LSA. Le funzioni LSA che restituiscono buffer di output a lunghezza variabile allocano sempre il buffer per conto del chiamante. Il chiamante deve liberare questa memoria passando il puntatore del buffer restituito a LsaFreeMemory quando la memoria non è più necessaria.

Sintassi

NTSTATUS LsaFreeMemory(
  [in] PVOID Buffer
);

Parametri

[in] Buffer

Puntatore al buffer di memoria allocato da una chiamata di funzione LSA. Se LsaFreeMemory ha esito positivo, questo buffer viene liberato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS, che può essere il valore seguente o uno dei valori restituiti della funzione criteri LSA.

Codice restituito Descrizione
STATUS_UNSUCCESSFUL
 Impossibile liberare la memoria perché non è stata allocata da una chiamata di funzione LSA.
 

È possibile utilizzare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecapi.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

Valori restituiti dalla funzione criteri LSA

LsaNtStatusToWinError