Fungsi TokenBindingGenerateBinding (tokenbinding.h)

Membuat satu pengikatan token yang berisi kunci publik dan tanda tangan yang diekspor dengan menggunakan jenis kunci yang ditentukan untuk pengikatan token, string pengidentifikasi target untuk membuat dan mengambil kunci pengikatan token, dan data unik. Fungsi ini juga mengembalikan pengidentifikasi pengikatan token, jika diperlukan.

Sintaks

SECURITY_STATUS TokenBindingGenerateBinding(
  [in]            TOKENBINDING_KEY_PARAMETERS_TYPE keyType,
  [in]            PCWSTR                           targetURL,
  [in]            TOKENBINDING_TYPE                bindingType,
  [in]            const void                       *tlsEKM,
  [in]            DWORD                            tlsEKMSize,
  [in]            TOKENBINDING_EXTENSION_FORMAT    extensionFormat,
  [in]            const void                       *extensionData,
  [out]           void                             **tokenBinding,
  [out]           DWORD                            *tokenBindingSize,
  [out, optional] TOKENBINDING_RESULT_DATA         **resultData
);

Parameter

[in] keyType

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

[in] targetURL

String target yang digunakan bersama dengan jenis kunci untuk menghasilkan atau mengambil kunci pengikatan token untuk operasi NCrypt yang membangun buffer untuk parameter tokenBinding .

[in] bindingType

Jenis pengikatan token yang harus dihasilkan TokenBindingGenerateBinding .

[in] tlsEKM

Penunjuk ke buffer yang berisi data unik.

[in] tlsEKMSize

Ukuran buffer yang dituju parameter tlsUnique , dalam byte.

[in] extensionFormat

Format yang digunakan untuk menginterpretasikan data dalam parameter extensionData . Nilai ini harus TOKENBINDING_EXTENSION_FORMAT_UNDEFINED.

[in] extensionData

Penunjuk ke buffer yang berisi data ekstensi. Nilai parameter extensionFormat menentukan cara menginterpretasikan data ini.

[out] tokenBinding

Pointer yang menerima alamat buffer pengikatan token. Gunakan fungsi HeapAlloc untuk mengalokasikan memori untuk buffer ini, dan fungsi HeapFree untuk membebaskan memori tersebut.

[out] tokenBindingSize

Penunjuk ke variabel yang menerima ukuran buffer yang dialokasikan untuk parameter tokenBinding , dalam byte.

[out, optional] resultData

Pointer yang menerima alamat buffer yang berisi data hasil yang menyertakan pengidentifikasi pengikatan token dari pengikatan token yang dihasilkan TokenBindingGenerateBinding . Gunakan fungsi HeapAlloc untuk mengalokasikan memori untuk buffer ini, dan fungsi HeapFree untuk membebaskan memori tersebut. Tentukan NULL adalah Anda tidak memerlukan informasi ini.

Menampilkan nilai

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Keterangan

Anda dapat memanggil TokenBindingGenerateBinding dari mode pengguna.

Persyaratan

   
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

Lihat juga

HeapAlloc

HeapFree

TOKENBINDING_EXTENSION_FORMAT

TOKENBINDING_RESULT_DATA

TOKENBINDING_TYPE

TokenBindingDeleteBinding

TokenBindingGetKeyTypesClient