LSA_FREE_CLIENT_BUFFER Rückruffunktion (ntsecpkg.h)
Gibt einen Clientpuffer frei, der zuvor der Funktion AllocateClientBuffer zugeordnet wurde.
Syntax
LSA_FREE_CLIENT_BUFFER LsaFreeClientBuffer;
NTSTATUS LsaFreeClientBuffer(
[in] PLSA_CLIENT_REQUEST ClientRequest,
[in] PVOID ClientBaseAddress
)
{...}
Parameter
[in] ClientRequest
Zeiger auf einen undurchsichtigen LSA_CLIENT_REQUEST Datentyp, der Informationen zur Anforderung des LSA-Clients enthält.
[in] ClientBaseAddress
Optional. Zeiger auf den zu befreienden Puffer. Diese Adresse ist die virtuelle Adresse des Puffers innerhalb des Clientprozesses, nicht im aktuellen Prozess. Wenn NULL übergeben wird, wird kein Arbeitsspeicher freigegeben. Dadurch kann der Client einen Wert übergeben, der vom LSA an ihn zurückgegeben wird, ohne zu wissen, ob der LSA tatsächlich einen Puffer zugewiesen hat.
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. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.
Die LsaNtStatusToWinError-Funktion konvertiert einen NTSTATUS-Code in einen Windows-Fehlercode.
Hinweise
Da diese Funktion Seiten im Clientprozess freigibt, muss sie mit großer Sorgfalt aufgerufen werden. Das Aufrufen dieser Funktion mit einer ungültigen Adresse kann dazu führen, dass der Clientprozess abstürzt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ntsecpkg.h |