次の方法で共有

Win32_Tpm クラスの TakeOwnership メソッド

  • [アーティクル]

Win32_Tpm クラスの TakeOwnership メソッドは、TPM の所有者をインストールします。 TPM の所有者は、TPM のすべての機能を利用できます。 所有者が設定されると、他のユーザーやソフトウェアが TPM の所有権を要求することはできません。

TakeOwnership メソッドが成功するには、IsEnabled メソッド、IsActivated メソッド、IsOwnershipAllowed メソッドがすべて true である必要があります。

構文

uint32 TakeOwnership(
  [in, optional] string OwnerAuth
);

パラメーター

OwnerAuth [in, optional]

型: string

TPM 所有者を識別する文字列。 この文字列は、20 バイトのバイナリ データを含む base64 でエンコードされた null で終わる文字列である必要があります。 パスフレーズをこの予期される形式に変換するには、 ConvertToOwnerAuth メソッドを使用します。 OwnerAuth パラメーターが指定されていない場合は、レジストリから読み取られます。

戻り値

型: uint32

すべての TPM エラーと、TPM 基本サービスに固有のエラーを返すことができます。

次の表に、一般的なリターン コードの一部を示します。

リターン コード/値 説明
S_OK
0 (0x0)
 メソッドは正常に実行されました。
E_INVALIDARG
2147942487 (0x80070057)
 OwnerAuth パラメーターが無効です。
TPM_E_OWNER_SET
2150105108 (0x80280014)
 所有者は TPM に既に存在します。
TPM_E_NO_ENDORSEMENT
2150105123 (0x80280023)
 TPM に保証キーが見つかりません。
TPM で保証キーペアを作成するには、 CreateEndorsementKeyPair メソッドを参照してください。
TPM_E_INSTALL_DISABLED
2150105099 (0x8028000B)
 所有者は、この TPM にインストールできません。
デバイス所有者のインストールを許可する方法については、「 SetPhysicalPresenceRequest」を参照してください。
TPM_E_DEFEND_LOCK_RUNNING
2150107139 (0x80280803)
 TPM はディクショナリ攻撃から防御しており、タイムアウト期間です。 詳細については、 ResetAuthLockOut メソッドを参照してください。

 

解説

TakeOwnership を成功させるには、IsEnabled、IsActivated、IsOwnershipAllowed の各メソッドがすべて true である必要があります。

ConvertToOwnerAuth メソッドを使用して、パスフレーズを OwnerAuth パラメーターに使用される入力値に変更する必要があります。

TakeOwnership メソッドは、適切なグループ ポリシー設定が構成されている場合、所有者の承認値を Active Directory にバックアップします。

マネージド オブジェクト形式 (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