fungsi Tbsi_Context_Create (tbs.h)
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 |
---|---|
|
Fungsi berhasil. |
|
Satu atau beberapa nilai parameter tidak valid. |
|
Terjadi kesalahan perangkat lunak internal. |
|
Parameter konteks yang tidak valid diteruskan saat mencoba membuat konteks TBS. |
|
Penunjuk output yang ditentukan tidak valid. |
|
Layanan TBS telah dinonaktifkan. |
|
Layanan TBS tidak berjalan dan tidak dapat dimulai. |
|
Layanan TBS telah dimulai tetapi belum berjalan. |
|
Konteks baru tidak dapat dibuat karena terlalu banyak konteks terbuka. |
|
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 |