Freigeben über

LSA_ALLOCATE_CLIENT_BUFFER Rückruffunktion (ntsecpkg.h)

  • Artikel

Weist einen Puffer im Adressraum des Clients zu. Puffer, die im Adressraum des Clients zugeordnet sind, werden verwendet, um Informationen zu enthalten, die aus einem Authentifizierungspaket an den Client zurückgegeben werden.

Syntax

LSA_ALLOCATE_CLIENT_BUFFER LsaAllocateClientBuffer;

NTSTATUS LsaAllocateClientBuffer(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  ULONG LengthRequired,
  [out] PVOID *ClientBaseAddress
)
{...}

Parameter

[in] ClientRequest

Zeiger auf eine nicht transparente LSA_CLIENT_REQUEST Datenstruktur, die Informationen zur Authentifizierungsanforderung des LSA-Clients enthält. Ein benutzerdefiniertes Authentifizierungspaket sollte den Wert übergeben, der während des Aufrufs des Clients an die Funktion empfangen wurde, z. B. LsaApCallPackage oder LsaApLogonUser, die den Ausgabeparameter zurückgibt.

[in] LengthRequired

Länge des benötigten Puffers in Bytes.

[out] ClientBaseAddress

Zeiger, der die Adresse des Puffers empfängt. Diese Adresse ist die virtuelle Adresse des Puffers innerhalb des Clientprozesses, nicht im aktuellen Prozess.

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_NO_MEMORY
 Der Clientprozess verfügt nicht über ein ausreichendes Speicherkontingent, um den Puffer zuzuweisen.
 

Die LsaNtStatusToWinError-Funktion konvertiert einen NTSTATUS-Code in einen Windows-Fehlercode.

Hinweise

Das Authentifizierungspaket oder der Clientprozess muss den Puffer später freigeben. Der Authentifizierungsprozess kann den Puffer mithilfe der FreeClientBuffer-Dispatchroutine freigeben. Der Clientprozess kann den Puffer mit der LsaFreeReturnBuffer-Funktion freigeben.

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 ntsecpkg.h

Weitere Informationen

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE