fungsi Tbsip_Submit_Command (tbs.h)

Artikel
08/26/2023

Mengirimkan perintah Modul Platform Tepercaya (TPM) ke TPM Base Services (TBS) untuk diproses.

Sintaks

TBS_RESULT Tbsip_Submit_Command(
  [in]      TBS_HCONTEXT         hContext,
  [in]      TBS_COMMAND_LOCALITY Locality,
  [in]      TBS_COMMAND_PRIORITY Priority,
  [in]      PCBYTE               pabCommand,
  [in]      UINT32               cbCommand,
  [out]     PBYTE                pabResult,
  [in, out] PUINT32              pcbResult
);

Parameter

[in] hContext

Handel konteks yang mengirimkan perintah.

[in] Locality

Digunakan untuk mengatur lokalitas untuk perintah TPM. Ini harus menjadi salah satu nilai berikut.

Nilai	Makna
TBS_COMMAND_LOCALITY_ZERO 0 (0x0)	Lokalitas nol. Ini adalah satu-satunya lokalitas yang saat ini didukung.
TBS_COMMAND_LOCALITY_ONE 1 (0x1)	Lokalitas satu.
TBS_COMMAND_LOCALITY_TWO 2 (0x2)	Lokalitas dua.
TBS_COMMAND_LOCALITY_THREE 3 (0x3)	Lokalitas tiga.
TBS_COMMAND_LOCALITY_FOUR 4 (0x4)	Lokalitas empat.

[in] Priority

Tingkat prioritas yang harus dimiliki perintah. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
TBS_COMMAND_PRIORITY_LOW 100 (0x64)	Digunakan untuk penggunaan aplikasi berprioritas rendah.
TBS_COMMAND_PRIORITY_NORMAL 200 (0xC8)	Digunakan untuk penggunaan aplikasi prioritas normal.
TBS_COMMAND_PRIORITY_SYSTEM 400 (0x190)	Digunakan untuk tugas sistem yang mengakses TPM.
TBS_COMMAND_PRIORITY_HIGH 300 (0x12C)	Digunakan untuk penggunaan aplikasi prioritas tinggi.
TBS_COMMAND_PRIORITY_MAX 2147483648 (0x80000000)	Digunakan untuk tugas yang berasal dari sistem manajemen daya.

[in] pabCommand

Penunjuk ke buffer yang berisi perintah TPM untuk diproses.

[in] cbCommand

Panjangnya, dalam byte, dari perintah.

[out] pabResult

Penunjuk ke buffer untuk menerima hasil perintah TPM. Buffer ini bisa sama dengan pabCommand.

[in, out] pcbResult

Bilangan bulat yang, pada input, menentukan ukuran, dalam byte, dari buffer hasil. Nilai ini diatur saat perintah kirim kembali. Jika buffer yang disediakan terlalu kecil, parameter ini, pada output, diatur ke ukuran yang diperlukan, dalam byte, untuk hasilnya.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan TBS_SUCCESS.

Perintah dapat berhasil dikirimkan dan masih gagal di TPM. Dalam hal ini, kode kegagalan dikembalikan sebagai kesalahan TPM standar dalam buffer hasil.

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_BUFFER_TOO_LARGE 2150121486 (0x8028400E)	Buffer input atau output terlalu besar.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Terjadi kesalahan perangkat lunak internal.
TBS_E_INSUFFICIENT_BUFFER 2150121477 (0x80284005)	Buffer output yang ditentukan terlalu kecil.
TBS_E_INVALID_CONTEXT 2150121476 (0x80284004)	Handel konteks yang ditentukan tidak merujuk ke konteks yang valid.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Penunjuk output yang ditentukan tidak valid.
TBS_E_IOERROR 2150121478 (0x80284006)	Terjadi kesalahan saat berkomunikasi dengan 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