Win32_EncryptableVolume 클래스의 UnlockWithNumericalPassword 메서드

  • 아티클

Win32_EncryptableVolume 클래스의 UnlockWithNumericalPassword 메서드는 제공된 숫자 암호를 사용하여 데이터 볼륨의 내용에 액세스합니다.

이 메서드를 사용하여 볼륨의 잠금을 해제하려면 볼륨의 암호화 키는 "Numerical Password" 형식( ProtectKeyWithNumericalPassword 메서드 사용)의 하나 이상의 키 보호기로 보호되어야 합니다.

참고

디스크가 하드웨어 암호화를 지원하는 경우 이 함수는 밴드 상태 "잠금 해제됨"으로 설정합니다.

 

구문

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

매개 변수

NumericalPassword [in]

형식: 문자열

숫자 암호를 지정하는 문자열입니다.

숫자 암호는 48자리를 포함해야 합니다. 이러한 숫자는 6자리의 8개 그룹으로 나눌 수 있으며 각 그룹의 마지막 숫자는 그룹에 대한 체크섬 값을 나타냅니다. 6자리 숫자의 각 그룹은 11로 나눌 수 있어야 하며 65536보다 작아야 합니다. 6자리 숫자 그룹이 x1, x2, x3, x4, x5 및 x6으로 레이블이 지정되었다고 가정하면 체크섬 x6 숫자는 –x1+x2–x3+x4–x5 모드 11로 계산됩니다.

숫자 그룹은 필요에 따라 공백 또는 하이픈으로 구분할 수 있습니다. 따라서 "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xx-xxxxxx-xxxxxx-xx-xx" 또는 "xxxxxx xx"도 유효한 숫자 암호를 포함할 수 있습니다.

반환 값

형식: uint32

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

볼륨이 이미 잠금 해제되어 있고 다른 오류가 발생하지 않으면 이 메서드는 0을 반환합니다.

반환 코드/값 Description
S_OK
0(0x0)
 메서드를 성공적으로 수행했습니다.
FVE_E_NOT_ACTIVATED
2150694920(0x80310008)
 BitLocker가 볼륨에서 활성화되지 않았습니다. BitLocker를 사용하도록 설정하는 키 보호기를 추가합니다.
FVE_E_PROTECTOR_NOT_FOUND
2150694963(0x80310033)
 볼륨에 "숫자 암호" 형식의 키 보호기가 없습니다.
NumericalPassword 매개 변수는 유효한 형식이지만 숫자 암호를 사용하여 볼륨의 잠금을 해제할 수는 없습니다.
FVE_E_FAILED_AUTHENTICATION
2150694951(0x80310027)
 NumericalPassword 매개 변수는 볼륨의 잠금을 해제할 수 없습니다.
"숫자 암호" 형식의 키 보호기가 하나 이상 있지만 지정된 NumericalPassword 매개 변수는 볼륨의 잠금을 해제할 수 없습니다.
FVE_E_INVALID_PASSWORD_FORMAT
2150694965(0x80310035)
 NumericalPassword 매개 변수에 유효한 형식이 없습니다.

 

설명

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