다음을 통해 공유

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 메서드가 완전히 암호 해독된 상태, 진행 중인 암호 해독 또는 암호 해독 일시 중지 상태에서 암호화를 시작하는 경우에만 적용됩니다. 이 비트가 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

이 메서드는 다음 코드 중 하나 또는 실패할 경우 다른 오류 코드 중 하나를 반환합니다.

반환 코드/값 Description
S_OK
0(0x0)
 메서드를 성공적으로 수행했습니다.
FVE_E_LOCKED_VOLUME
2150694912(0x80310000)
 볼륨이 잠겨 있습니다.

 

설명

MOF(Managed Object Format) 파일에는 WMI(Windows Management Instrumentation) 클래스에 대한 정의가 포함되어 있습니다. MOF 파일은 Windows SDK의 일부로 설치되지 않습니다. 서버 관리자 사용하여 연결된 역할을 추가할 때 서버에 설치됩니다. MOF 파일에 대한 자세한 내용은 MOF(관리 개체 형식)를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista Enterprise, Windows Vista Ultimate [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
네임스페이스
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

추가 정보

Win32_EncryptableVolume