次の方法で共有

Win32_EncryptableVolume クラスの GetHardwareTestStatus メソッド

  • [アーティクル]

Win32_EncryptableVolume クラスの GetHardwareTestStatus メソッドは、完全に復号化されたオペレーティング システム ボリュームのハードウェア テストに関する状態情報を提供します。

ハードウェア テストが保留中かどうか、および最後のコンピューターの再起動時に完了したハードウェア テストの成功または失敗を表示するには、このメソッドを使用します。 ハードウェア テストを要求するには、 EncryptAfterHardwareTest メソッドを使用します。

構文

uint32 GetHardwareTestStatus(
  [out] uint32 TestStatus,
  [out] uint32 TestError
);

パラメーター

TestStatus [out]

型: uint32

ハードウェア テストが保留中かどうか、および最後のコンピューターの再起動時に完了したハードウェア テストの失敗の成功を指定します。

値 説明
NotFailed_and_NonePending
0
 テストが要求された場合、最後のコンピューターの再起動時にテストが成功し、ボリュームの暗号化が進行中です。 暗号化の状態については、 GetConversionStatus メソッドを参照してください。 それ以外の場合、最後のコンピューターの再起動時にテストは実行されておらず、保留中のテストはありません。
失敗
1
 ボリューム暗号化が開始されませんでした。 すべてのキー保護機能が削除されました。
失敗したテストを解決するには:
  • TestError パラメーターの情報を参照してください。
  • キー保護機能を追加し、 EncryptAfterHardwareTest メソッドをもう一度使用します。
保留中
2
 テストが要求され、次のコンピューターの再起動時に実行されます。

 

TestError [out]

型: uint32

最後に完了したハードウェア テストのエラーを指定します。

値 説明
0
 エラーが発生しなかったか、最後のコンピューターの再起動時にハードウェア テストが実行されていない。
2150694972 (0x8031003C)
 FVE_E_KEYFILE_NOT_FOUND
外部キー ファイルを含む USB フラッシュ ドライブが見つかりませんでした。 このエラーが解決しない場合、コンピューターは再起動中に USB ドライブを読み取ることができません。 再起動中に、外部キーを使用してオペレーティング システム ボリュームのロックを解除できない場合があります。
2150694973 (0x8031003D)
 FVE_E_KEYFILE_INVALID
USB フラッシュ ドライブの外部キー ファイルが破損しています。 外部キー ファイルを保存するには、別の USB フラッシュ ドライブを試してください。
2150694975 (0x8031003F)
 FVE_E_TPM_DISABLED
TPM が無効または非アクティブ化されているか、無効と非アクティブの両方です。 TPM を有効にするには、 Win32_Tpm WMI プロバイダーを使用するか、TPM 管理スナップイン (Tpm.msc) を実行します。
2150694977 (0x80310041)
 FVE_E_TPM_INVALID_PCR
TPM は、現在のプラットフォーム検証プロファイル内のオペレーティング システム再起動サービスの変更を検出しました。 コンピューターからスタートアップ CD または DVD を削除します。 このエラーが解決しない場合は、最新のファームウェアと BIOS のアップグレードがインストールされていること、および TPM が正常に動作していることをチェックします。
2150694979 (0x80310043)
 FVE_E_PIN_INVALID
指定された PIN が正しくありません。

 

戻り値

型: uint32

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

リターン コード/値 説明
S_OK
0 (0x0)
 メソッドが成功しました。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 ボリュームがロックされています。

 

解説

ハードウェア テストを要求するには、 EncryptAfterHardwareTest メソッドを使用します。

状態が保留中のときにハードウェア テストを実行するには、次の手順に従います。

  1. 外部キー ファイルを含む USB フラッシュ ドライブをコンピューターに挿入します。 この手順は、ボリュームに "外部キー" または "TPM およびスタートアップ キー" の種類のキー保護機能がある場合にのみ適用されます。
  2. コンピューターを再起動します。 コンピューターの再起動時に、ハードウェア テストが自動的に実行されます。

ハードウェア テストをキャンセルするには、 Encrypt メソッドを使用します。

成功したテストでは、次のことが判断されます。

  • TPM 関連のキー保護機能が存在する場合、TPM はボリュームのロックを解除できます。
  • ボリュームを外部キー (スタートアップ キーを含む) でロックを解除できる場合、コンピューターは起動時に外部キー ファイルを含む USB フラッシュ ドライブを読み取ることができます。

変換の変更後、または次のコンピューターの再起動後に、ハードウェア テストの結果は使用できません。 システム イベント ログで、コンピューターで以前に実行されたハードウェア テストに関する情報を確認します。

マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Windows SDK の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられているロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista Enterprise、Windows Vista Ultimate [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
名前空間
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

関連項目

Win32_EncryptableVolume