Win32_EncryptableVolume 클래스의 UnlockWithExternalKey 메서드
Win32_EncryptableVolume 클래스의 UnlockWithExternalKey 메서드는 제공된 외부 키를 사용하여 데이터 볼륨의 내용에 액세스합니다.
이 메서드를 사용하여 볼륨의 잠금을 해제하려면 ProtectKeyWithExternalKey 메서드를 사용하여 "외부 키" 형식의 하나 이상의 키 보호기로 볼륨의 암호화 키를 보호해야 합니다.
참고
디스크가 하드웨어 암호화를 지원하는 경우 이 함수는 밴드 상태 "잠금 해제됨"으로 설정합니다.
구문
uint32 UnlockWithExternalKey(
[in] uint8 ExternalKey[]
);
매개 변수
-
ExternalKey [in]
-
형식: uint8[]
볼륨 잠금을 해제하는 데 사용되는 256비트 외부 키를 지정하는 바이트 배열입니다. 이 키는 GetExternalKeyFromFile 메서드를 호출하여 가져올 수 있습니다.
반환 값
형식: uint32
이 메서드는 다음 코드 중 하나 또는 실패할 경우 다른 오류 코드 중 하나를 반환합니다.
볼륨이 이미 잠금 해제된 경우 이 메서드는 0을 반환합니다.
| 반환 코드/값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
볼륨에 "외부 키" 형식의 키 보호기가 없습니다. |
|
"외부 키" 형식의 키 보호기가 하나 이상 있지만 지정된 ExternalKey 매개 변수는 볼륨의 잠금을 해제할 수 없습니다. |
|
ExternalKey 매개 변수는 크기 4의 배열이 아닙니다. |
|
BitLocker가 볼륨에서 활성화되지 않았습니다. BitLocker를 사용하도록 설정하는 키 보호기를 추가합니다. |
설명
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 |
|
추가 정보