Share via

CompleteAuthToken-Funktion (sspi.h)

  • Artikel

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