TokenBindingVerifyMessage 函式 (tokenbinding.h)

發行項
03/05/2024

驗證令牌系結訊息，並驗證訊息所包含的令牌系結。

語法

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
標頭	tokenbinding.h
程式庫	Tokenbinding.lib
Dll	Tokenbinding.dll (使用者模式) ;Ksecdd.sys (核心模式)