fungsi Tbsi_Context_Create (tbs.h)

Artikel
03/08/2023

Membuat handel konteks yang dapat digunakan untuk meneruskan perintah ke TBS.

Sintaks

TBS_RESULT Tbsi_Context_Create(
  [in]  PCTBS_CONTEXT_PARAMS pContextParams,
  [out] PTBS_HCONTEXT        phContext
);

Parameter

[in] pContextParams

Parameter ke struktur TBS_CONTEXT_PARAMS yang berisi parameter yang terkait dengan konteks.

[out] phContext

Penunjuk ke lokasi untuk menyimpan handel konteks baru.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TBS_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan kode pengembalian TBS yang menunjukkan kesalahan.

Mengembalikan kode/nilai	Deskripsi
TBS_SUCCESS 0 (0x0)	Fungsi berhasil.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Satu atau beberapa nilai parameter tidak valid.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Terjadi kesalahan perangkat lunak internal.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	Parameter konteks yang tidak valid diteruskan saat mencoba membuat konteks TBS.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Penunjuk output yang ditentukan tidak valid.
TBS_E_SERVICE_DISABLED 2150121488 (0x80284010)	Layanan TBS telah dinonaktifkan.
TBS_E_SERVICE_NOT_RUNNING 2150121480 (0x80284008)	Layanan TBS tidak berjalan dan tidak dapat dimulai.
TBS_E_SERVICE_START_PENDING 2150121483 (0x8028400B)	Layanan TBS telah dimulai tetapi belum berjalan.
TBS_E_TOO_MANY_TBS_CONTEXTS 2150121481 (0x80284009)	Konteks baru tidak dapat dibuat karena terlalu banyak konteks terbuka.
TBS_E_TPM_NOT_FOUND 2150121487 (0x8028400F)	Perangkat Keamanan Modul Platform Tepercaya (TPM) yang kompatibel tidak dapat ditemukan pada komputer ini.

Keterangan

Struktur TBS_CONTEXT_PARAMS dapat disediakan, dengan bidang versi diatur ke TPM_VERSION_12. Aplikasi yang berinteraksi dengan TPM versi 2.0 akan meneruskan penunjuk ke struktur TBS_CONTEXT_PARAMS2 , dengan bidang versi diatur ke TPM_VERSION_20. Atur bidang yang dipesan ke 0, dan bidang includeTPm20 ke 1. Jika aplikasi disiapkan untuk berinteraksi dengan TPM versi 1.2 juga (jika sistem tidak memiliki TPM versi 2.0), atur bidang includeTpm12 ke 1.

Jika tidak ada TPM pada sistem, atau versi TPM tidak cocok dengan yang diminta oleh pemanggil, Tbsi_Context_Create akan mengembalikan kode kesalahan TBS_E_TPM_NOT_FOUND (0x8028400). Program aplikasi harus memeriksa kedua versi dan dapat berinteraksi dengan salah satu TPM.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	tbs.h
Pustaka	Tbs.lib
DLL	Tbs.dll

Bagikan melalui