Win32_Tpm 類別的 ConvertToOwnerAuth 方法

  • 發行項

Win32_Tpm類別的ConvertToOwnerAuth方法會將使用者提供的複雜密碼輸入轉譯成 20 位元組擁有者授權，可用來與 TPM 互動。 TakeOwnership和ResetAuthLockOut之類的方法需要產生的擁有者授權值。

轉換程式遵循 來自信任運算群組的規格。

語法

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 雜湊中不會使用 salt。

例如，若要將 TPM 擁有者複雜密碼 「1Sample」 轉換為 TPM 擁有者授權值，SHA-1 雜湊會取自下列位元組資料流程：

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

若要將長度為零的複雜密碼轉換為擁有者授權值，會採用 Null 位元組資料流程的 SHA-1 雜湊。

Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Windows SDK 的一部分。 當您使用 伺服器管理員 新增相關聯的角色時，它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊，請參閱 Managed Object Format (MOF) 。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
命名空間
 Root\CIMV2\Security\MicrosoftTpm
MOF
Win32_tpm.mof
DLL
Win32_tpm.dll

另請參閱

Win32_Tpm

TakeOwnership