Win32_EncryptableVolume 클래스의 GetKeyPackage 메서드

  • 아티클

Win32_EncryptableVolume 클래스의 GetKeyPackage 메서드는 드라이브가 심각하게 손상되고 데이터 백업 파일이 없을 때 암호화된 데이터를 회수하는 데 도움이 될 수 있는 정보를 내보냅니다.

내보낸 정보는 "숫자 암호" 또는 "외부 키" 형식의 키 보호자에 의해 보호되는 볼륨의 암호화 키로 구성됩니다. 이 패키지를 사용하려면 해당 숫자 암호 또는 외부 키도 저장해야 합니다.

중요

키 패키지를 내보내도록 선택하는 경우 이 정보를 잘 보호된 위치에 유지해야 합니다. 컴퓨터와 함께 이 정보를 전달하지 마세요. 이 키 패키지를 분실하거나 도난당한 경우 볼륨의 암호를 해독하고 새 키를 사용하여 다시 암호화해야 합니다.

 

드라이브 오류가 발생할 경우 사용 가능한 데이터를 복구하는 데 도움이 되는 BitLocker 복구 도구가 있습니다. 이 도구가 키 패키지를 사용하는 방법에 대한 자세한 내용은 BitLocker 복구 도구를 사용하여 Windows Vista의 암호화된 볼륨에서 데이터를 복구하는 방법을 참조하세요.

구문

uint32 GetKeyPackage(
  [in]  string VolumeKeyProtectorID,
  [out] uint8  KeyPackage[]
);

매개 변수

VolumeKeyProtectorID [in]

형식: 문자열

암호화된 볼륨 키 보호기를 관리하는 데 사용되는 고유한 문자열 식별자입니다. 키 패키지를 내보내려면 "숫자 암호" 또는 "외부 키" 유형의 키 보호기를 사용해야 합니다.

KeyPackage[] [out]

형식: uint8

지정된 키 보호기를 통해 보호되는 볼륨의 암호화 키를 포함하는 바이트 스트림입니다.

반환 값

형식: uint32

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

반환 코드/값 Description
S_OK
0(0x0)
 메서드를 성공적으로 수행했습니다.
FVE_E_LOCKED_VOLUME
2150694912(0x80310000)
 볼륨이 잠겨 있습니다.
FVE_E_NOT_ACTIVATED
2150694920(0x80310008)
 BitLocker가 볼륨에서 활성화되지 않았습니다. BitLocker를 사용하도록 설정하는 키 보호기를 추가합니다.
FVE_E_PROTECTOR_NOT_FOUND
2150694963(0x80310033)
 제공된 키 보호기가 볼륨에 없습니다.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970(0x8031003A)
 VolumeKeyProtectorID 매개 변수는 "숫자 암호" 또는 "외부 키" 형식의 키 보호기를 참조하지 않습니다. ProtectKeyWithNumericalPassword 또는 ProtectKeyWithExternalKey 메서드를 사용하여 적절한 형식의 키 보호기를 만듭니다.

 

설명

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