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
針對標準硬碟 (HDD) ,磁片區會完全解密。
對於硬體加密硬碟 (EHDD) ,磁片區會永久解除鎖定。
FullyEncrypted
1
針對標準硬碟 (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方法從完全解密狀態開始加密、進行中解密狀態或解密暫停狀態時,這個位才會生效。 如果這個位是零,表示它未設定,在啟動新的加密程式時,將會執行完整模式轉換。
0x00000002
執行磁片區可用空間的隨選抹除。 只有在磁片區目前未轉換或抹除且處於「加密」狀態時,才允許使用此位集的 Encrypt 方法。
0x00010000
同步執行要求的作業。 呼叫將會封鎖,直到要求的作業完成或中斷為止。 只有 Encrypt 方法才支援此旗標。 呼叫 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)
磁片區已鎖定。

 

備註

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

規格需求

需求 值
最低支援的用戶端
Windows Vista Enterprise、Windows Vista Ultimate [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2008 [僅限傳統型應用程式]
命名空間
Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

另請參閱

Win32_EncryptableVolume