LSA_AP_CALL_PACKAGE_PASSTHROUGH Rückruffunktion (ntsecpkg.h)

Artikel
02/29/2024

Die Dispatchfunktion für Passthrough-Anmeldeanforderungen, die an die LsaCallAuthenticationPackage-Funktion gesendet werden.

Syntax

LSA_AP_CALL_PACKAGE_PASSTHROUGH LsaApCallPackagePassthrough;

NTSTATUS LsaApCallPackagePassthrough(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  PVOID ProtocolSubmitBuffer,
  [in]  PVOID ClientBufferBase,
  [in]  ULONG SubmitBufferLength,
  [out] PVOID *ProtocolReturnBuffer,
  [out] PULONG ReturnBufferLength,
  [out] PNTSTATUS ProtocolStatus
)
{...}

Parameter

[in] ClientRequest

Zeiger auf einen undurchsichtigen LSA_CLIENT_REQUEST Puffer, der die Anforderung des LSA-Clients darstellt.

[in] ProtocolSubmitBuffer

Stellt dem Authentifizierungspaket eine protokollspezifische Nachricht bereit.

[in] ClientBufferBase

Stellt die Adresse innerhalb des Clientprozesses der Protokollnachricht bereit. Dies kann erforderlich sein, um Zeiger innerhalb des ProtocolSubmitBuffer neu zuzuordnen.

[in] SubmitBufferLength

Gibt die Länge des ProtocolSubmitBuffer-Puffers in Bytes an.

[out] ProtocolReturnBuffer

Gibt die Adresse des Ausgabepuffers im Clientprozess zurück. Das Authentifizierungspaket ist dafür verantwortlich, die Funktion AllocateClientBuffer aufzurufen, um den Puffer im Clientprozess zuzuweisen. Der Inhalt dieses Puffers ist spezifisch für das Authentifizierungspaket.

[out] ReturnBufferLength

Zeiger auf eine ULONG, die die Länge des ProtocolReturnBuffer-Puffers in Bytes zurückgibt.

[out] ProtocolStatus

Zeiger auf einen NTSTATUS-Wert. Wenn die Funktion STATUS_SUCCESS zurückgibt, gibt ProtocolStatus eine Vervollständigung zurück, die vom Authentifizierungspaket festgelegt status. ProtocolStatus-Werte sind spezifisch für das Authentifizierungspaket.

Weitere Informationen zu NTSTATUS-Codes finden Sie in der Datei Subauth.h, die im Lieferumfang des Platform SDK enthalten ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück. Dieser Rückgabewert gibt an, dass das Authentifizierungspaket versucht hat, den angeforderten Dienst bereitzustellen. Verwenden Sie den ProtocolStatus-Parameter, um die Vervollständigung status der Dienstanforderung zurückzugeben.

Wenn das Authentifizierungspaket die Anforderung nicht verarbeiten konnte und daher nicht versucht hat, den angeforderten Dienst bereitzustellen, geben Sie einen NTSTATUS-Code zurück, der das Problem angibt. Bei diesem Code kann es sich um den folgenden Wert oder um einen der Rückgabewerte der LSA-Richtlinienfunktion handeln.

Rückgabecode	Beschreibung
STATUS_NO_MEMORY	Das Arbeitsspeicherkontingent des Clients reicht nicht aus, um den Ausgabepuffer zuzuweisen.

Hinweise

Diese Funktion muss durch Authentifizierungspakete implementiert werden.

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

AllocateClientBuffer

LsaCallAuthenticationPackage

Freigeben über