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)

Confira também

ExAllocatePoolWithTag

ExFreePool

TOKENBINDING_RESULT_LIST

TokenBindingGenerateMessage

TokenBindingGetKeyTypesServer