Bagikan melalui

fungsi Tbsip_Submit_Command (tbs.h)

  • Artikel

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