Функция TokenBindingVerifyMessage (tokenbinding.h)

Статья
08/26/2023

Проверяет сообщение о привязке маркера и проверяет привязки маркера, содержащиеся в сообщении.

Синтаксис

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
Header	tokenbinding.h
Библиотека	Tokenbinding.lib
DLL	Tokenbinding.dll (пользовательский режим); Ksecdd.sys (режим ядра)