Função TokenBindingVerifyMessage (tokenbinding.h)
Valida a mensagem de associação de token e verifica as associações de token que a mensagem contém.
Sintaxe
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
Um ponteiro para o buffer que contém a mensagem de associação de token.
[in] tokenBindingMessageSize
O tamanho do buffer para o qual o parâmetro tokenBindingMessage aponta, em bytes.
[in] keyType
O algoritmo de chave negociado a ser usado. Use um valor da lista de tipos de chave recuperados chamando a função TokenBindingGetKeyTypesServer .
[in] tlsEKM
Um ponteiro para um buffer que contém dados exclusivos.
[in] tlsEKMSize
O tamanho do buffer para o qual o parâmetro tlsUnique aponta, em bytes.
[out] resultList
Um ponteiro que recebe o endereço do buffer que contém os resultados de cada uma das associações de token verificadas por TokenBindingVerifyMessage .
No modo de usuário, use HeapAlloc para alocar a memória para o buffer e HeapFree para liberar essa memória. No modo kernel, use ExAllocatePoolWithTag para alocar a memória para o buffer e ExFreePool para liberar essa memória.
Retornar valor
Retorna um código status que indica o êxito ou a falha da função.
Comentários
Você pode chamar TokenBindingVerifyMessage do modo de usuário e do modo kernel. o chama essa função no modo kernel, vincula a Ksecdd.sys e usa as funções mencionadas na descrição do parâmetro resultList para alocar e liberar memória.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | tokenbinding.h |
| Biblioteca | Tokenbinding.lib |
| DLL | Tokenbinding.dll (modo de usuário); Ksecdd.sys (modo kernel) |