TokenBindingVerifyMessage 函数 (tokenbinding.h)

项目
03/02/2024

验证令牌绑定消息并验证消息包含的令牌绑定。

语法

SECURITY_STATUS TokenBindingVerifyMessage(
  [in]  const void                       *tokenBindingMessage,
  [in]  DWORD                            tokenBindingMessageSize,
  [in]  TOKENBINDING_KEY_PARAMETERS_TYPE keyType,
  [in]  const void                       *tlsEKM,
  [in]  DWORD                            tlsEKMSize,
  [out] TOKENBINDING_RESULT_LIST         **resultList
);

参数

[in] tokenBindingMessage

指向包含令牌绑定消息的缓冲区的指针。

[in] tokenBindingMessageSize

tokenBindingMessage 参数指向的缓冲区的大小（以字节为单位）。

[in] keyType

要使用的协商密钥算法。使用通过调用 TokenBindingGetKeyTypesServer 函数检索的密钥类型列表中的值。

[in] tlsEKM

指向包含唯一数据的缓冲区的指针。

[in] tlsEKMSize

tlsUnique 参数指向的缓冲区的大小（以字节为单位）。

[out] resultList

一个指针，用于接收缓冲区的地址，该缓冲区包含 TokenBindingVerifyMessage 验证的每个令牌绑定的结果。

在用户模式下，使用 HeapAlloc 为缓冲区分配内存，使用 HeapFree 释放该内存。在内核模式下，使用 ExAllocatePoolWithTag 为缓冲区分配内存，使用 ExFreePool 释放该内存。

返回值

返回指示函数成功或失败的状态代码。

注解

可以从用户模式和内核模式调用 TokenBindingVerifyMessage 。 o 在内核模式下调用此函数，链接到 Ksecdd.sys，并使用 resultList 参数说明中提到的函数来分配和释放内存。

要求

要求	值
最低受支持的客户端	Windows 10 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
目标平台	Windows
标头	tokenbinding.h
Library	Tokenbinding.lib
DLL	Tokenbinding.dll (用户模式) ;Ksecdd.sys (内核模式)