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 |
|
DLL |
|