Win32_EncryptableVolume 클래스의 ProtectKeyWithPassphrase 메서드

  • 아티클

Win32_EncryptableVolume 클래스의 ProtectKeyWithPassphrase 메서드는 암호를 사용하여 파생 키를 가져옵니다. 파생 키를 계산한 후 파생 키를 사용하여 암호화된 볼륨의 master 키를 보호합니다.

구문

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

매개 변수

FriendlyName [in, optional]

형식: 문자열

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

암호 [in]

형식: 문자열

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

VolumeKeyProtectorID [out]

형식: 문자열

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

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

반환 값

형식: uint32

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

반환 코드/값 Description
S_OK
0(0x0)
 메서드를 성공적으로 수행했습니다.
FVE_E_NOT_ALLOWED_IN_SAFE_MODE
2150694976(0x80310040)
 BitLocker 드라이브 암호화는 안전 모드에서 사용되는 경우에만 복구 목적으로 사용할 수 있습니다.
FVE_E_POLICY_PASSPHRASE_NOT_ALLOWED
2150695018(0x8031006A)
 그룹 정책은 암호 생성을 허용하지 않습니다.
FVE_E_FIPS_PREVENTS_PASSPHRASE
2150695020(0x8031006C)
 FIPS 규정 준수가 필요한 그룹 정책 설정으로 인해 암호가 생성되거나 사용되지 않습니다.
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040(0x80310080)
 제공된 암호가 최소 또는 최대 길이 요구 사항을 충족하지 않습니다.
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041(0x80310081)
 암호는 그룹 정책에서 관리자가 설정한 복잡성 요구 사항을 충족하지 않습니다.
FVE_E_LOCKED_VOLUME
2150694912(0x80310000)
 볼륨은 BitLocker 드라이브 암호화에 의해 이미 잠겨 있습니다. 제어판 드라이브의 잠금을 해제해야 합니다.
FVE_E_OVERLAPPED_UPDATE
2150694948(0x80310024)
 암호화된 볼륨의 제어 블록이 다른 스레드에 의해 업데이트되었습니다.
FVE_E_KEY_PROTECTOR_NOT_SUPPORTED
2150695017(0x80310069)
 키 보호기는 현재 볼륨에 있는 BitLocker 드라이브 암호화 버전에서 지원되지 않습니다.
FVE_E_OS_VOLUME_PASSPHRASE_NOT_ALLOWED
2150695021(0x8031006D)
 암호를 운영 체제 볼륨에 추가할 수 없습니다.
FVE_E_PROTECTOR_EXISTS
2150694960(0x80310030)
 제공된 키 보호기가 이 볼륨에 이미 있습니다.

 

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 7 Enterprise, Windows 7 Ultimate [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 R2 [데스크톱 앱만 해당]
네임스페이스
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

추가 정보

Win32_EncryptableVolume