CIM_TPM 类的 RequestTPMStateChange 方法

  • 项目

请求将 TPM 的状态更改为 RequestedTPMState 参数中指定的值。 如果方法调用成功完成， 则 TPMState 属性应等于 RequestedTPMState 参数。 多次调用 RequestTPMStateChange 方法可能会导致早期请求被覆盖或丢失。

语法

uint32 RequestTPMStateChange(
  [in]  uint16              RequestedTPMState,
  [in]  string              AuthorizationToken,
  [out] CIM_ConcreteJob REF Job,
  [in]  datetime            TimeoutPeriod
);

参数

RequestedTPMState [in]

请求的 TPM 状态。

S1 已启用主动拥有 的 (2)

S2 已禁用-主动拥有 的 (3)

S3 已启用非活动拥有 的 (4)

S4 禁用非活动拥有 的 (5)

S5 Enabled-Active-Unowned (6)

S6 Disabled-Active-Unowned (7)

S7 Enabled-Inactive-Unowned (8)

S8 Disabled-Inactive-Unowned (9)

DMTF 保留 (。)

供应商预留 (32768..65535)

AuthorizationToken [in]

操作生效可能需要的授权令牌。 可能需要 AuthorizationToken 参数来建立物理状态，或传递 OwnerAuth（TCG 定义的所有者授权密码）。 对于 OwnerAuth，可能需要具有非 null 值 CIM_SharedCredential.Secret 的CIM_SharedCredential。 还可以根据 CIM_TPMCapabilities.SupportedPasswordAlgorithms 的属性指定 CIM_SharedCredential.Algorithm 属性。

作业 [out]

可以包含对为跟踪由方法调用启动的状态转换而创建的 CIM_ConcreteJob 的引用。

TimeoutPeriod [in]

一个超时期限，指定客户端希望转换到新状态所花费的最长时间。 必须使用间隔格式指定 TimeoutPeriod。 值为 0 或 null 参数表示客户端对转换没有时间要求。

返回值

成功后，返回 0 或 4096;否则，将返回错误。

已完成，无错误 (0)

不支持 (1)

未知或未指定错误 (2)

无法在超时期限内完成 (3)

失败 (4)

参数 (5) 无效

In Use (6)

DMTF 保留 (。)

已检查方法参数 - 作业 启动 (4096)

无效状态转换 (4097)

(4098) 不支持使用超时参数

繁忙 (4099)

方法保留 (4100..32767)

供应商特定 (32768..65535)

要求

要求 值
最低受支持的客户端
 Windows 10 [仅限桌面应用]
最低受支持的服务器
 Windows Server 2016
命名空间
 Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另请参阅

CIM_TPM