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 返回代码。

返回代码/值 说明
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 版本与调用方请求的版本不匹配， Tbsi_Context_Create 将返回TBS_E_TPM_NOT_FOUND (0x8028400) 错误代码。 应用程序必须为这两个版本检查，并且能够与任一 TPM 交互。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 tbs.h
Library Tbs.lib
DLL Tbs.dll