LSA_ALLOCATE_CLIENT_BUFFER Rückruffunktion (ntsecpkg.h)
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 |
|---|---|
|
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 |