Win32_Tpm 类的 SetPhysicalPresenceRequest 方法

  • 项目

Win32_Tpm 类的 SetPhysicalPresenceRequest 方法请求需要物理存在的 TPM 操作。 使用此方法提交请求后，请应用 GetPhysicalPresenceTransition 方法中指示的下一步。 最后，使用 GetPhysicalPresenceResponse 方法检查操作是否成功运行。 如果调用可能导致需要 BitLocker 恢复，此方法将挂起 BitLocker。 预配 TPM 后，BitLocker 将自动恢复。

这些步骤是必需的，因为物理状态操作只能在计算机检测到物理存在的用户之后运行。

语法

uint32 SetPhysicalPresenceRequest(
  [in] uint32 Request
);

parameters

请求 [in]

类型： uint32

一个整数值，该值指定请求的需要物理存在的 TPM 操作。

值 含义
0
 未请求。
使用此值可以清除挂起的请求。
1
 启用 TPM。
此操作由操作 2 撤消。
有关详细信息，请参阅以下不涉及物理状态的相关方法： Enable 和 IsEnabled。
2
 禁用 TPM。
此操作由操作 1 撤消。
有关详细信息，请参阅以下不涉及物理状态的相关方法： 禁用。
3
 激活 TPM。
此操作由操作 4 撤消。
4
 停用 TPM。
此操作由操作 3 撤消。
5
 清除 TPM。
此操作无法撤消。
有关详细信息，请参阅以下不涉及物理存在的相关方法： 清除。
6
 启用并激活 TPM。
此操作由操作 7 撤消。
7
 停用和禁用 TPM。
此操作由操作 6 撤消。
8
 允许安装 TPM 所有者。
此操作由操作 9 撤消。
9
 阻止安装 TPM 所有者。
此操作由操作 8 撤消。
10
 启用、激活并允许安装 TPM 所有者。
此操作由操作 11 撤消。
11
 停用、禁用和阻止安装 TPM 所有者。
此操作由操作 10 撤消。
12
 延迟物理存在unownedFieldUpgrade
物理状态设置已更新。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
14
 清除、启用和激活 TPM。
此操作无法撤消。
15
 SetNoPPIProvision_False
设置必须实际存在才能设置 TPM 的预配。
此操作由操作 16 撤消。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
16
 SetNoPPIProvision_True
设置不需要在物理上存在的预配来设置 TPM。
此操作由操作 15 撤消。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
17
 SetNoPPIClear_False
设置必须实际存在才能清除 TPM 的预配。
此操作由操作 18 撤消。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
18
 SetNoPPIClear_True
设置不需要在物理上存在以清除 TPM 的预配。
此操作由操作 17 撤消。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
19
 SetNoPPIMaintenance_False
设置必须实际存在才能维护 TPM 的预配。
此操作由操作 20 撤消。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
20
 SetNoPPIMaintenance_True
设置不需要在物理上存在以维护 TPM 的预配。
此操作由操作 19 撤消。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
21
 启用 + 激活 + 清除
启用、激活和清除 TPM。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。
22
 启用 + 激活 + 清除 + 启用 + 激活
启用、激活和清除 TPM，然后启用并重新激活 TPM。
Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 不支持此值。

 

返回值

类型： uint32

可以返回所有 TPM 错误以及特定于 TPM 基本服务的错误。

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
使用 GetPhysicalPresenceTransition 方法确定所需的下一步。
TPM_E_PPI_NOT_SUPPORTED
2150171395 (0x80290303)
计算机不支持使用此方法执行 TPM 物理状态操作。
有关详细信息，请咨询您的计算机制造商。 计算机的 BIOS 可能具有配置 TPM 的备用支持。
TPM_E_PPI_ACPI_FAILURE
2150171392 (0x80290300)
发生了硬件故障。
有关详细信息，请咨询您的计算机制造商。

 

备注

TPM 物理状态操作不需要 TPM 所有者授权。 但是，它们确实需要其他步骤来帮助防止对 TPM 进行未经授权的更改。

支持 TPM 物理状态操作的计算机将在运行操作之前尝试检测物理存在的用户。 虽然计算机执行此检测的方式可能不同，但想法是让实际存在的用户或管理员授权操作。

例如，计算机可能要求用户重新启动计算机。 重启计算机后，计算机可以显示 BIOS 确认对话框，该对话框允许用户使用键盘确认操作。

托管对象格式 (MOF) 文件包含 Windows Management Instrumentation (WMI) 类的定义。 MOF 文件未作为 Windows SDK 的一部分安装。 使用 服务器管理器 添加关联角色时，这些角色将安装在服务器上。 有关 MOF 文件的详细信息，请参阅 托管对象格式 (MOF) 。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
命名空间
 Root\CIMV2\Security\MicrosoftTpm
MOF
Win32_tpm.mof
DLL
Win32_tpm.dll

请参阅

Win32_Tpm

启用

IsEnabled

禁用

清除