ApplyControlToken 函数 (sspi.h)

ApplyControlToken 函数提供了一种将控制令牌应用于安全上下文的方法。通过调用 InitializeSecurityContext (Schannel) 函数或使用按消息安全服务（例如验证或取消密封）建立安全上下文时，可以接收令牌。

Schannel 安全支持提供程序 (SSP) 仅支持此函数。

内核模式不支持此函数。

此函数允许将其他或替换令牌应用于上下文。

语法

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

[in] phContext

应用令牌的上下文的句柄。

有关 Schannel SSP 通知远程方关闭的方式的信息，请参阅 DecryptMessage (Schannel) 的“备注”部分。有关使用此函数的其他信息，请参阅关闭 Schannel 连接。

[in] pInput

指向 SecBufferDesc 结构的指针，该结构包含指向 SecBuffer 结构的指针，该结构包含要应用于上下文的输入标记。

如果函数成功，该函数将返回SEC_E_OK。

如果函数失败，它将返回非零错误代码。以下错误代码是可以返回的可能错误代码之一。

返回代码	说明
SEC_E_UNSUPPORTED_FUNCTION	此值由 Schannel 内核模式返回，指示不支持此函数。

ApplyControlToken 函数可以根据此令牌修改上下文。此函数可以添加到客户端上下文的标记中包括SCHANNEL_ALERT_TOKEN 和 SCHANNEL_SESSION_TOKEN。

此函数可用于关闭现有 Schannel 连接的安全上下文。有关如何执行此操作的信息，请参阅关闭 Schannel 连接。