Función TokenBindingVerifyMessage (tokenbinding.h)

Valida el mensaje de enlace de tokens y comprueba los enlaces de token que contiene el mensaje.

Sintaxis

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
);

Parámetros

[in] tokenBindingMessage

Puntero al búfer que contiene el mensaje de enlace de tokens.

[in] tokenBindingMessageSize

Tamaño del búfer al que apunta el parámetro tokenBindingMessage , en bytes.

[in] keyType

Algoritmo de clave negociado que se va a usar. Use un valor de la lista de tipos de clave que recuperó mediante una llamada a la función TokenBindingGetKeyTypesServer .

[in] tlsEKM

Puntero a un búfer que contiene datos únicos.

[in] tlsEKMSize

Tamaño del búfer al que apunta el parámetro tlsUnique , en bytes.

[out] resultList

Puntero que recibe la dirección del búfer que contiene los resultados de cada uno de los enlaces de token que TokenBindingVerifyMessage comprueba.

En el modo de usuario, use HeapAlloc para asignar la memoria del búfer y HeapFree para liberar esa memoria. En el modo kernel, use ExAllocatePoolWithTag para asignar la memoria del búfer y ExFreePool para liberar esa memoria.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Comentarios

Puede llamar a TokenBindingVerifyMessage desde el modo de usuario y el modo kernel. o llame a esta función en modo kernel, vincule a Ksecdd.sys y use las funciones mencionadas en la descripción del parámetro resultList para asignar y liberar memoria.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tokenbinding.h
Library	Tokenbinding.lib
Archivo DLL	Tokenbinding.dll (modo de usuario); Ksecdd.sys (modo kernel)

Consulte también

ExAllocatePoolWithTag

ExFreePool

TOKENBINDING_RESULT_LIST

TokenBindingGenerateMessage

TokenBindingGetKeyTypesServer