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