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 Enabled-Active-Owned (2)

S2 Disabled-Active-Owned (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) 无效

使用 (6)

DMTF 保留 (.。)

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

状态转换 无效 (4097)

(4098) 不支持使用 Timeout 参数

(4099)

保留方法 (4100..32767)

供应商特定 (32768..65535)

要求

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

另请参阅

CIM_TPM