LSA_FREE_CLIENT_BUFFER Rückruffunktion (ntsecpkg.h)

  • Artikel

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

Weitere Informationen

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE