次の方法で共有

Win32_EncryptableVolume クラスの GetConversionStatus メソッド

  • [アーティクル]

Win32_EncryptableVolume クラスの GetConversionStatus メソッドは、ボリュームの暗号化または暗号化解除の状態を示します。

構文

uint32 GetConversionStatus(
  [out] uint32 ConversionStatus,
  [out] uint32 EncryptionPercentage,
  [out] uint32 EncryptionFlags,
  [out] uint32 WipingStatus,
  [out] uint32 WipingPercentage,
  [in]  uint32 PrecisionFactor
);

パラメーター

ConversionStatus [out]

型: uint32

ボリュームの暗号化または暗号化解除の状態。 次のいずれかの値を指定できます。

値 説明
FullyDecrypted
0
 Standard ハード ドライブ (HDD) の場合、ボリュームは完全に暗号化解除されます。
ハードウェアで暗号化されたハード ドライブ (EHDD) の場合、ボリュームは永続的にロック解除されます。
FullyEncrypted
1
 Standard ハード ドライブ (HDD) の場合、ボリュームは完全に暗号化されます。
ハードウェアで暗号化されたハード ドライブ (EHDD) の場合、ボリュームは永続的にロック解除されません。
EncryptionInProgress
2
 ボリュームは部分的に暗号化されます。
DecryptionInProgress
3
 ボリュームは部分的に暗号化されます。
EncryptionPaused
4
 暗号化の進行状況中にボリュームが一時停止されました。 ボリュームは部分的に暗号化されます。
DecryptionPaused
5
 暗号化解除の進行中にボリュームが一時停止されました。 ボリュームは部分的に暗号化されます。

 

EncryptionPercentage [out]

型: uint32

暗号化されたボリュームの割合。 これは、0 から 100 までの整数です。

数値の丸めにより、暗号化の割合が 0 または 100 の場合、必ずしもディスクが完全に暗号化解除または完全に暗号化されていることを示すわけではありません。 ConversionStatus を常に使用して、ディスクが実際に完全に暗号化解除されているか、完全に暗号化されているかを判断します。

EncryptionFlags [out]

型: uint32

暗号化の動作を記述するフラグ。

次のビットが現在定義されている 32 ビットの組み合わせ。

値 説明
0x00000001
 新しい暗号化プロセスを開始するときに、データのみの暗号化モードでボリューム暗号化を実行します。 暗号化が一時停止または停止されている場合、 Encrypt メソッドを呼び出すと実質的に変換が再開され、このビットの値は無視されます。 このビットは、Encrypt メソッドまたは EncryptAfterHardwareTest メソッドが、完全に暗号化解除された状態、進行中の状態の復号化、または暗号化解除の一時停止状態から暗号化を開始する場合にのみ有効です。 このビットが 0 の場合、これは設定されていないことを意味し、新しい暗号化プロセスを開始するときに、フル モード変換が実行されます。
0x00000002
 ボリュームの空き領域のオンデマンド ワイプを実行します。 このビット セットを使用して Encrypt メソッドを呼び出すことは、ボリュームが現在変換またはワイプされておらず、"暗号化された" 状態にある場合にのみ許可されます。
0x00010000
 要求された操作を同期的に実行します。 呼び出しは、要求された操作が完了するか、中断されるまでブロックされます。 このフラグは、 Encrypt メソッドでのみサポートされます。 このフラグは、 暗号化 を呼び出して、暗号化の停止または中断またはワイプを再開する場合、または暗号化またはワイプが進行中の場合に指定できます。 これにより、呼び出し元は、プロセスが完了するか中断されるまで同期的に待機を再開できます。

 

WipingStatus [out]

型: uint32

空き領域のワイプ状態。 次のいずれかの値を指定できます。

値 説明
FreeSpaceNotWiped
0
 空き領域がワイプされていません。
FreeSpaceWiped
1
 空き領域がワイプされました。
FreeSpaceWipingInProgress
2
 空き領域のワイプは現在進行中です。
FreeSpaceWipingPaused
3
 空き領域のワイプが一時停止されました。

 

WipingPercentage [out]

型: uint32

ワイプされた空き領域の割合を指定する 0 ~ 100 の値。

PrecisionFactor [in]

型: uint32

精度レベルを指定する 0 ~ 4 の値

戻り値

型: uint32

このメソッドは、次のいずれかのコードまたは失敗した場合は別のエラー コードを返します。

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

 

解説

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