Win32 EncryptableVolume 클래스의 ProtectKeyWithPassphrase 메서드 _

Win32 _ EncryptableVolume 클래스의 ProtectKeyWithPassphrase 메서드는 암호를 사용 하 여 파생 키를 가져옵니다. 파생 키가 계산 된 후에는 파생 키가 암호화 된 볼륨의 마스터 키를 보호 하는 데 사용 됩니다.

구문

uint32 ProtectKeyWithPassphrase(
  [in, optional] string FriendlyName,
  [in]           string Passphrase,
  [out]          string VolumeKeyProtectorID
);

매개 변수

FriendlyName [ 에서, 선택 사항]

형식: 문자열

이 키 보호기의 사용자 할당 문자열 식별자를 지정 하는 문자열입니다. 이 매개 변수를 지정 하지 않으면 빈 값이 사용 됩니다.

암호 [ 진행]

형식: 문자열

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

VolumeKeyProtectorID [ 제한이]

형식: 문자열

만든 키 보호기를 고유 하 게 식별 하는 문자열입니다.

드라이브가 하드웨어 암호화를 지원 하 고 BitLocker에서 대역 소유권을 사용 하지 않은 경우 ID 문자열은 "BitLocker"로 설정 되 고 키 보호기는 대역 별 메타 데이터에 기록 됩니다.

반환 값

형식: uint32

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

반환 코드/값 Description
S _ 확인
0 (0x0)
메서드를 성공적으로 수행했습니다.
Fve _ E _ _ _ _ 안전 _ 모드 2150694976에서는 허용 되지 않음
(0x80310040)
BitLocker 드라이브 암호화는 안전 모드에서 사용 하는 경우 복구 목적 으로만 사용할 수 있습니다.
Fve _ E _ 정책 _ 암호 _ 는 _ 허용 되지 않음
2150695018 (0x8031006a)
그룹 정책에서 암호 생성을 허용 하지 않습니다.
Fve _ E _ FIPS _ 는 _ 암호
2150695020 (0x8031006c)를
방지 합니다.
FIPS 규정 준수를 요구 하는 그룹 정책 설정으로 인해 암호를 생성 하거나 사용할 수 없습니다.
Fve _ E _ 정책 _ 잘못 된 _ 암호 _ 길이
2150695040 (0x80310080)
입력 한 암호가 최소 또는 최대 길이 요구 사항을 충족 하지 않습니다.
Fve _ E _ 정책 _ 암호가 _ 너무 _ 단순
2150695041 (0x80310081)
암호가 그룹 정책에서 관리자가 설정한 복잡성 요구 사항을 충족 하지 않습니다.
Fve _ E _ 잠김 _ 볼륨
2150694912 (0x80310000)
볼륨이 BitLocker 드라이브 암호화에 의해 이미 잠겨 있습니다. 제어판에서 드라이브의 잠금을 해제 해야 합니다.
Fve _ E _ 겹쳐진 _ 업데이트
2150694948 (0x80310024)
암호화 된 볼륨에 대 한 제어 블록이 다른 스레드에 의해 업데이트 되었습니다.
Fve _ E _ 키 _ 보호기 _ 가 _ 지원 되지 않음
2150695017 (0x80310069)
현재 볼륨에 있는 BitLocker 드라이브 암호화 버전에서 키 보호기를 지원 하지 않습니다.
Fve _ E _ OS _ 볼륨 _ 암호 _ 를 _ 사용할 수 없습니다
.
2150695021 (0x8031006D)
운영 체제 볼륨에 암호를 추가할 수 없습니다.
Fve _ E _ 보호기 _ EXISTS
2150694960 (0x80310030)
제공 된 키 보호기가이 볼륨에 이미 있습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 7 Enterprise, Windows 7 Ultimate [ desktop 앱 전용]
지원되는 최소 서버
Windows Server 2008 R2 [ 데스크톱 앱만]
네임스페이스
Root \ CIMV2 \ 보안 \ MicrosoftVolumeEncryption
MOF
Win32 _ encryptablevolume

참고 항목

Win32 _ EncryptableVolume