Fungsi TokenBindingVerifyMessage (tokenbinding.h)

Artikel
08/26/2023

Memvalidasi pesan pengikatan token dan memverifikasi pengikatan token yang dikandung pesan.

Sintaks

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
);

Parameter

[in] tokenBindingMessage

Penunjuk ke buffer yang berisi pesan pengikatan token.

[in] tokenBindingMessageSize

Ukuran buffer yang dirujuk parameter tokenBindingMessage , dalam byte.

[in] keyType

Algoritma kunci yang dinegosiasikan untuk digunakan. Gunakan nilai dari daftar jenis kunci yang Anda ambil dengan memanggil fungsi TokenBindingGetKeyTypesServer .

[in] tlsEKM

Penunjuk ke buffer yang berisi data unik.

[in] tlsEKMSize

Ukuran buffer yang dituju parameter tlsUnique , dalam byte.

[out] resultList

Penunjuk yang menerima alamat untuk buffer yang berisi hasil untuk setiap pengikatan token yang diverifikasi TokenBindingVerifyMessage .

Dalam mode pengguna, gunakan HeapAlloc untuk mengalokasikan memori untuk buffer, dan HeapFree untuk membebaskan memori tersebut. Dalam mode kernel, gunakan ExAllocatePoolWithTag untuk mengalokasikan memori untuk buffer, dan ExFreePool untuk membebaskan memori tersebut.

Nilai kembali

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Keterangan

Anda dapat memanggil TokenBindingVerifyMessage dari mode pengguna dan mode kernel. o memanggil fungsi ini dalam mode kernel, menautkan ke Ksecdd.sys, dan menggunakan fungsi yang disebutkan dalam deskripsi untuk parameter resultList untuk mengalokasikan dan membebaskan memori.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	tokenbinding.h
Pustaka	Tokenbinding.lib
DLL	Tokenbinding.dll (mode pengguna); Ksecdd.sys (mode kernel)