共用方式為

Tbsip_Submit_Command函式 (tbs.h)

  • 發行項

將信賴平臺模組 (TPM) 命令提交至 TPM 基礎服務 (TBS) 進行處理。

語法

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
);

參數

[in] hContext

正在提交命令之內容的句柄。

[in] Locality

用來設定 TPM 命令的區域。 這必須是下列其中一個值。

值 意義
TBS_COMMAND_LOCALITY_ZERO
0 (0x0)
位置零。 這是目前唯一支持的地區。
TBS_COMMAND_LOCALITY_ONE
1 (0x1)
第一個位置。
TBS_COMMAND_LOCALITY_TWO
2 (0x2)
位置 2。
TBS_COMMAND_LOCALITY_THREE
3 (0x3)
位置三。
TBS_COMMAND_LOCALITY_FOUR
4 (0x4)
位置四。

[in] Priority

命令應該具有的優先順序層級。 此參數可以是下列其中一個值。

值 意義
TBS_COMMAND_PRIORITY_LOW
100 (0x64)
用於低優先順序的應用程式使用。
TBS_COMMAND_PRIORITY_NORMAL
200 (0xC8)
用於一般優先順序的應用程式使用。
TBS_COMMAND_PRIORITY_SYSTEM
400 (0x190)
 用於存取 TPM 的系統工作。
TBS_COMMAND_PRIORITY_HIGH
300 (0x12C)
 用於高優先順序的應用程式使用。
TBS_COMMAND_PRIORITY_MAX
2147483648 (0x80000000)
用於源自電源管理系統的工作。

[in] pabCommand

緩衝區的指標，其中包含要處理的 TPM 命令。

[in] cbCommand

命令的長度，以位元組為單位。

[out] pabResult

要接收 TPM 命令結果之緩衝區的指標。 此緩衝區可以與 pabCommand 相同。

[in, out] pcbResult

在輸入時，輸入的整數會指定結果緩衝區的大小，以位元組為單位。 當送出命令傳回時，會設定此值。 如果提供的緩衝區太小，則輸出上的此參數會設定為結果所需的大小，以位元組為單位。

傳回值

如果函式成功，函式會傳回TBS_SUCCESS。

命令可以成功提交，但仍會在 TPM 失敗。 在此情況下，失敗碼會以結果緩衝區中的標準 TPM 錯誤傳回。

如果函式失敗，它會傳回指出錯誤的 TBS 傳回碼。

傳回碼/值 Description
TBS_SUCCESS
0 (0x0)
函式成功。
TBS_E_BAD_PARAMETER
2150121474 (0x80284002)
一或多個參數值無效。
TBS_E_BUFFER_TOO_LARGE
2150121486 (0x8028400E)
輸入或輸出緩衝區太大。
TBS_E_INTERNAL_ERROR
2150121473 (0x80284001)
發生內部軟體錯誤。
TBS_E_INSUFFICIENT_BUFFER
2150121477 (0x80284005)
指定的輸出緩衝區太小。
TBS_E_INVALID_CONTEXT
2150121476 (0x80284004)
指定的內容句柄不會參考有效的內容。
TBS_E_INVALID_OUTPUT_POINTER
2150121475 (0x80284003)
指定的輸出指標無效。
TBS_E_IOERROR
2150121478 (0x80284006)
與 TPM 通訊時發生錯誤。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 tbs.h
程式庫 Tbs.lib
Dll Tbs.dll