Win32 Tpm 类的 ConvertToOwnerAuth 方法 _

Win32 _ Tpm类的 ConvertToOwnerAuth 方法将用户提供的通行短语输入转换为20字节所有者授权,可用于与 Tpm 交互。 诸如 TakeOwnershipResetAuthLockOut 之类的方法要求生成的所有者授权值。

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

语法

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

参数

OwnerPassPhrase [中]

类型: string

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

OwnerAuth [弄]

类型: string

派生自 OwnerPassPhrase 参数的字符串。 此值为20字节的二进制值,其编码为28字节 base64 以 null 结尾的字符串。

返回值

类型: uint32

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

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

返回代码/值 说明
S _正常
0 (0x0)
方法成功。

备注

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

例如,若要将 TPM 所有者密码 "1Sample" 转换为 TPM 所有者授权值,请从以下字节流获取 SHA-1 哈希:

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

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

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

要求

要求
最低受支持的客户端
Windows[仅适用于 Vista 桌面应用]
最低受支持的服务器
Windows[仅限 Server 2008 桌面应用]
命名空间
根 \ CIMV2 \ 安全 \ MicrosoftTpm
MOF
Win32 _ tpm
DLL
Win32 _tpm.dll

请参阅

Win32 _ Tpm

TakeOwnership