Win32_Tpm 類別的 ConvertToOwnerAuth 方法

Win32_Tpm類別的ConvertToOwnerAuth方法會將使用者提供的複雜密碼輸入轉譯為 20 位元組擁有者授權,可用來與 TPM 互動。 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 雜湊中不會使用 Salt。

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

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

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

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

規格需求

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

另請參閱

Win32_Tpm

TakeOwnership