ApplyControlToken-Funktion (sspi.h)
Die ApplyControlToken-Funktion bietet eine Möglichkeit, ein Steuerelementtoken auf einen Sicherheitskontext anzuwenden. Ein Token kann empfangen werden, wenn der Sicherheitskontext durch einen Aufruf der Funktion InitializeSecurityContext (Schannel) oder mit einem Sicherheitsdienst pro Nachricht eingerichtet wird, z. B. überprüfen oder nicht.
Diese Funktion wird nur vom Schannel-Sicherheitssupportanbieter (SSP) unterstützt.
Diese Funktion wird im Kernelmodus nicht unterstützt.
Mit dieser Funktion können zusätzliche oder ersetzungstoken auf einen Kontext angewendet werden.
Syntax
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
[in] PCtxtHandle phContext,
[in] PSecBufferDesc pInput
);
Parameter
[in] phContext
Ein Handle für den Kontext, auf den das Token angewendet wird.
Informationen dazu, wie der Schannel-SSP die Remotepartei des Herunterfahrens benachrichtigt, finden Sie im Abschnitt "Hinweise" von DecryptMessage (Schannel). Weitere Informationen zur Verwendung dieser Funktion finden Sie unter Herunterfahren einer Schannel-Verbindung.
[in] pInput
Ein Zeiger auf eine SecBufferDesc-Struktur , die einen Zeiger auf eine SecBuffer-Struktur enthält, die das Eingabetoken enthält, das auf den Kontext angewendet werden soll.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion SEC_E_OK zurück.
Wenn die Funktion fehlschlägt, wird ein Fehlercode ohne Zero zurückgegeben. Der folgende Fehlercode ist eine der möglichen Fehlercodes, die zurückgegeben werden können.
| Rückgabecode | Beschreibung |
|---|---|
|
Dieser Wert wird vom Schannel-Kernelmodus zurückgegeben, um anzugeben, dass diese Funktion nicht unterstützt wird. |
Bemerkungen
Die ApplyControlToken-Funktion kann den Kontext basierend auf diesem Token ändern. Zu den Token, die diese Funktion dem Clientkontext hinzufügen kann, gehören SCHANNEL_ALERT_TOKEN und SCHANNEL_SESSION_TOKEN.
Diese Funktion kann verwendet werden, um den Sicherheitskontext zu beenden, der eine vorhandene Schannel-Verbindung unterlies. Informationen dazu finden Sie unter Herunterfahren einer Schannel-Verbindung.
Anforderungen
| 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 |