LsaFreeMemory-Funktion (ntsecapi.h)

Die LsaFreeMemory-Funktion gibt arbeitsspeicher frei, der durch einen LSA-Funktionsaufruf für einen Ausgabepuffer zugeordnet ist. LSA-Funktionen, die Ausgabepuffer mit variabler Länge zurückgeben, ordnen den Puffer immer im Namen des Aufrufers zu. Der Aufrufer muss diesen Arbeitsspeicher freigeben, indem er den zurückgegebenen Pufferzeiger an LsaFreeMemory übergibt, wenn der Arbeitsspeicher nicht mehr benötigt wird.

Syntax

NTSTATUS LsaFreeMemory(
  [in] PVOID Buffer
);

Parameter

[in] Buffer

Zeiger auf den Speicherpuffer, der durch einen LSA-Funktionsaufruf zugeordnet wurde. Wenn LsaFreeMemory erfolgreich ist, wird dieser Puffer freigegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code, der der folgende Wert oder einer der Rückgabewerte der LSA-Richtlinienfunktion sein kann.

Rückgabecode Beschreibung
STATUS_UNSUCCESSFUL
Arbeitsspeicher konnte nicht freigegeben werden, da er nicht durch einen LSA-Funktionsaufruf zugeordnet wurde.
 

Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecapi.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

Rückgabewerte der LSA-Richtlinienfunktion

LsaNtStatusToWinError