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
Library	Tokenbinding.lib
[DLL]	Tokenbinding.dll (ユーザーモード);Ksecdd.sys (カーネルモード)