Win32_Tpm类的 ConvertToOwnerAuth 方法

Win32_Tpm类的 ConvertToOwnerAuth 方法将用户提供的通行短语输入转换为可用于与 TPM 交互的 20 字节所有者授权。 TakeOwnershipResetAuthLockOut 等方法需要生成的所有者授权值。

转换过程遵循 受信任的计算组中的规范。

语法

uint32 ConvertToOwnerAuth(
  [in]  string OwnerPassPhrase,
  [out] string OwnerAuth
);

参数

OwnerPassPhrase [in]

类型: 字符串

要转换为所有者授权值的字符串。 字符串可以包含任意数量的字母数字字符。

OwnerAuth [out]

类型: 字符串

派生自 OwnerPassPhrase 参数的字符串。 此值是编码为 28 字节 base64 null 终止字符串的 20 字节二进制值。

返回值

类型: uint32

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

下表列出了一些常见的返回代码。

返回代码/值 说明
S_OK
0 (0x0)
该方法成功。

 

注解

Unicode UTF-16LE 编码字符串通过将字符串的二进制表示形式的 SHA-1 哈希转换为 20 字节 TPM 所有者授权值。 Unicode 字符串的 null 终止不包括在哈希中。 SHA-1 哈希中不使用盐。

例如,若要将 TPM 所有者通行短语“1Sample”转换为 TPM 所有者授权值,SHA-1 哈希取自以下字节流:

0x31 0x00 0x53 0x00 0x61 0x00 0x6D 0x00 0x70 0x00 0x6C 0x00 0x65 0x00

若要将零长度通行短语转换为所有者授权值,SHA-1 哈希将采用 NULL 字节流。

托管对象格式 (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

TakeOwnership