Win32_EncryptableVolume 클래스의 ProtectKeyWithNumericalPassword 메서드
Win32_EncryptableVolume 클래스의 ProtectKeyWithNumericalPassword 메서드는 특별히 형식이 지정된 48자리 암호로 볼륨의 암호화 키를 보호합니다. 이 숫자 암호는 다른 키 보호기의 인증 실패(예: TPM)에서 복구하는 데 사용할 수 있습니다.
볼륨에 대해 "숫자 암호" 형식의 키 보호기가 만들어집니다.
IsNumericalPasswordValid 메서드를 사용하여 숫자 암호 형식의 유효성을 검사합니다.
구문
uint32 ProtectKeyWithNumericalPassword(
[in, optional] string FriendlyName,
[in, optional] string NumericalPassword,
[out] string VolumeKeyProtectorID
);
매개 변수
-
FriendlyName [in, optional]
-
형식: 문자열
이 키 보호기에서 사용자가 할당한 식별자를 지정하는 문자열입니다. 이 매개 변수를 지정하지 않으면 빈 값이 사용됩니다.
-
NumericalPassword [in, optional]
-
형식: 문자열
특수하게 서식이 지정된 48자리 숫자 암호를 지정하는 문자열입니다.
숫자 암호는 48자리를 포함해야 합니다. 이러한 숫자는 6자리의 8개 그룹으로 나눌 수 있으며 각 그룹의 마지막 숫자는 그룹에 대한 체크섬 값을 나타냅니다. 6자리 숫자의 각 그룹은 11로 나눌 수 있어야 하며 720885 이하여야 합니다. 6자리 숫자 그룹이 x1, x2, x3, x4, x5 및 x6으로 레이블이 지정되었다고 가정하면 체크섬 x6 숫자는 –x1+x2–x3+x4–x5 모드 11로 계산됩니다.
숫자 그룹은 선택적으로 공백 또는 하이픈으로 구분할 수 있습니다. 따라서 "xxxxxx-xxxxxx-xxxxxx-xx-xxxxxx-xxxxxx-xx-xx" 또는 "xx xx"도 유효한 숫자 암호를 포함할 수 있습니다.
숫자 암호를 지정하지 않으면 임의로 생성됩니다. GetKeyProtectorNumericalPassword 메서드를 사용하여 임의로 생성된 암호를 가져옵니다.
-
VolumeKeyProtectorID [out]
-
형식: 문자열
생성된 보호기와 연결된 고유 식별자이며 키 보호기를 관리하는 데 사용할 수 있는 문자열입니다.
드라이브가 하드웨어 암호화를 지원하고 BitLocker가 대역 소유권을 가져오지 않은 경우 ID 문자열은 "BitLocker"로 설정되고 키 보호기는 대역별 메타데이터에 기록됩니다.
반환 값
형식: uint32
이 메서드는 다음 코드 중 하나 또는 실패할 경우 다른 오류 코드 중 하나를 반환합니다.
| 반환 코드/값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
NumericalPassword 매개 변수에 유효한 형식이 없습니다. |
|
볼륨이 잠겨 있습니다. |
|
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 |
|
추가 정보