共用方式為

Tbsi_Context_Create函式 (tbs.h)

  • 發行項

建立可用來將命令傳遞至 TBS 的內容句柄。

語法

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

參數

[in] pContextParams

包含與內容相關聯之參數 之TBS_CONTEXT_PARAMS 結構的參數。

[out] phContext

要儲存新內容句柄之位置的指標。

傳回值

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

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

傳回碼/值 Description
TBS_SUCCESS
0 (0x0)
函式成功。
TBS_E_BAD_PARAMETER
2150121474 (0x80284002)
一或多個參數值無效。
TBS_E_INTERNAL_ERROR
2150121473 (0x80284001)
發生內部軟體錯誤。
TBS_E_INVALID_CONTEXT_PARAM
2150121479 (0x80284007)
嘗試建立 TBS 內容時，傳遞無效的內容參數。
TBS_E_INVALID_OUTPUT_POINTER
2150121475 (0x80284003)
指定的輸出指標無效。
TBS_E_SERVICE_DISABLED
2150121488 (0x80284010)
TBS 服務已停用。
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
TBS 服務未執行且無法啟動。
TBS_E_SERVICE_START_PENDING
2150121483 (0x8028400B)
TBS 服務已啟動，但尚未執行。
TBS_E_TOO_MANY_TBS_CONTEXTS
2150121481 (0x80284009)
無法建立新的內容，因為有太多開啟的內容。
TBS_E_TPM_NOT_FOUND
2150121487 (0x8028400F)
無法在此計算機上找到相容的信賴平臺模組 (TPM) 安全性裝置。

備註

您可以提供 TBS_CONTEXT_PARAMS 結構，並將版本字段設定為 TPM_VERSION_12。 與 2.0 版 TPM 互動的應用程式會將指標傳遞至 TBS_CONTEXT_PARAMS2 結構，並將版本欄位設定為 TPM_VERSION_20。 將保留欄位設定為 0，並將 includeTPm20 字段設定為 1。 如果應用程式已準備好與 1.2 版 TPM 互動，並在系統沒有 2.0 版 TPM) 時 (，請將 includeTpm12 字段設定為 1。

如果系統上沒有 TPM，或 TPM 版本不符合呼叫者所要求的 TPM，Tbsi_Context_Create 將會傳回TBS_E_TPM_NOT_FOUND (0x8028400) 错误码。 應用程式必須檢查兩個版本，而且能夠與任一個 TPM 互動。

規格需求

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