completeAuthToken 函数 (sspi.h)

  • 项目

CompleteAuthToken 函数完成身份验证令牌。 此函数由协议（如 DCE）使用，这些协议需要在传输应用程序更新某些消息参数后修改安全信息。

只有摘要 式安全支持提供程序 (SSP) 才支持此函数。

CompleteAuthToken 仅在服务器端使用。

语法

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

参数

[in] phContext

需要完成的上下文的句柄。

[in] pToken

指向 SecBufferDesc 结构的指针，该结构包含整个消息的缓冲区描述符。

返回值

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

如果该函数失败，它将返回以下错误代码之一。

返回代码 说明
SEC_E_INVALID_HANDLE
 传递给函数的句柄无效。
SEC_E_INVALID_TOKEN
 传递给函数的令牌无效。
SEC_E_OUT_OF_SEQUENCE
 已找到客户端的安全上下文，但消息号不正确。 此返回值与摘要 SSP 一起使用。
SEC_E_MESSAGE_ALTERED
 已找到客户端的安全上下文，但客户端的消息已被篡改。 此返回值与摘要 SSP 一起使用。
SEC_E_INTERNAL_ERROR
 发生了未映射到 SSPI 错误代码的错误。

注解

传输应用程序的客户端调用 CompleteAuthToken 函数，以允许 安全包 在传输应用程序更新所有协议标头后更新校验和或类似操作。 仅当 InitializeSecurityContext (Digest) 调用SEC_I_COMPLETE_NEEDED或SEC_I_COMPLETE_AND_CONTINUE返回时，客户端才会调用此函数。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 sspi.h (包括 Security.h)
Library Secur32.lib
DLL Secur32.dll

另请参阅

InitializeSecurityContext (摘要)

SSPI 函数

SecBufferDesc