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