CompleteAuthToken-Funktion (sspi.h)

Artikel
08/26/2023

Die Funktion CompleteAuthToken schließt ein Authentifizierungstoken ab. Diese Funktion wird von Protokollen wie DCE verwendet, die die Sicherheitsinformationen überarbeiten müssen, nachdem die Transportanwendung einige Nachrichtenparameter aktualisiert hat.

Diese Funktion wird nur vom Digest Security Support Provider (SSP) unterstützt.

CompleteAuthToken wird nur auf der Serverseite verwendet.

Syntax

SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pToken
);

Parameter

[in] phContext

Ein Handle des Kontexts, der abgeschlossen werden muss.

[in] pToken

Ein Zeiger auf eine SecBufferDesc-Struktur , die den Pufferdeskriptor für die gesamte Nachricht enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion SEC_E_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück.

Rückgabecode	Beschreibung
SEC_E_INVALID_HANDLE	Das an die Funktion übergebene Handle ist ungültig.
SEC_E_INVALID_TOKEN	Das an die Funktion übergebene Token ist ungültig.
SEC_E_OUT_OF_SEQUENCE	Der Sicherheitskontext des Clients wurde gefunden, aber die Nachrichtennummer ist falsch. Dieser Rückgabewert wird mit dem Digest-SSP verwendet.
SEC_E_MESSAGE_ALTERED	Der Sicherheitskontext des Clients wurde gefunden, aber die Nachricht des Clients wurde manipuliert. Dieser Rückgabewert wird mit dem Digest-SSP verwendet.
SEC_E_INTERNAL_ERROR	Es ist ein Fehler aufgetreten, der keinem SSPI-Fehlercode zugeordnet wurde.

Hinweise

Der Client einer Transportanwendung ruft die Funktion CompleteAuthToken auf, damit das Sicherheitspaket eine Prüfsumme oder einen ähnlichen Vorgang aktualisieren kann, nachdem alle Protokollheader von der Transportanwendung aktualisiert wurden. Der Client ruft diese Funktion nur auf, wenn der InitializeSecurityContext -Aufruf (Digest) SEC_I_COMPLETE_NEEDED oder SEC_I_COMPLETE_AND_CONTINUE zurückgegeben hat.

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	sspi.h (einschließlich Security.h)
Bibliothek	Secur32.lib
DLL	Secur32.dll

Weitere Informationen

InitializeSecurityContext (Digest)

SSPI-Funktionen

SecBufferDesc

Freigeben über