TokenBindingVerifyMessage 函式 (tokenbinding.h)
驗證令牌系結訊息,並驗證訊息所包含的令牌系結。
語法
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 (核心模式) |