Win32 Tpm 類別的 ConvertToOwnerAuth 方法 _

Win32 _ Tpm類別的 ConvertToOwnerAuth 方法會將使用者提供的複雜密碼輸入轉譯為20位元組的擁有者授權,以用來與 Tpm 互動。 TakeOwnershipResetAuthLockOut等方法都需要產生的擁有者授權值。

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

語法

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

參數

OwnerPassPhrase [在]

類型: 字串

要轉換為擁有者授權值的字串。 字串可以包含任何數目的英數位元。

OwnerAuth [擴展]

類型: 字串

衍生自 OwnerPassPhrase 參數的字串。 這個值是20位元組的二進位值,編碼為28位元組 base64 以 null 終止的字串。

傳回值

類型: uint32

您可以傳回所有 TPM 錯誤以及 TPM 基礎服務特定的錯誤。

下表列出一些常見的傳回碼。

傳回碼/值 Description
S _確定
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 雜湊。

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

規格需求

需求
最低支援的用戶端
[僅限 Windows Vista 桌面應用程式]
最低支援的伺服器
僅限 Windows Server 2008 [ desktop 應用程式]
命名空間
根 \ CIMV2 \ 安全性 \ MicrosoftTpm
MOF
Win32 _ tpm。 mof
DLL
Win32 _tpm.dll

另請參閱

Win32 _ Tpm

TakeOwnership