Win32 EncryptableVolume 클래스의 ProtectKeyWithExternalKey 메서드 _

Win32 _ EncryptableVolume 클래스의 ProtectKeyWithExternalKey 메서드는 256 비트 외부 키를 사용 하 여 볼륨의 암호화 키를 보호 합니다. 이 외부 키는 다른 키 보호기 (예: TPM)의 인증 오류를 복구 하는 데 사용할 수 있습니다.

Saveexternalkeytofile 메서드를 사용 하 여이 외부 키를 파일에 저장 합니다. 컴퓨터가 시작 될 때이 외부 키를 포함 하는 USB 메모리 장치를 시작 키 또는 복구 키로 사용할 수 있습니다.

볼륨에 대해 "External Key" 유형의 키 보호기가 만들어집니다.

구문

uint32 ProtectKeyWithExternalKey(
  [in, optional] string FriendlyName,
  [in, optional] uint8  ExternalKey[],
  [out]          string VolumeKeyProtectorID
);

매개 변수

FriendlyName [ 에서, 선택 사항]

형식: 문자열

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

Externalkey [ 에서, 선택 사항]

유형: uint8 [ ]

볼륨의 잠금을 해제 하는 데 사용 되는 256 비트 외부 키를 지정 하는 바이트 배열입니다.

외부 키가 지정 되지 않은 경우 하나는 임의로 생성 됩니다. GetKeyProtectorExternalKey 메서드를 사용 하 여 임의로 생성 된 키를 가져옵니다.

VolumeKeyProtectorID [ 제한이]

형식: 문자열

암호화 된 볼륨 키 보호기를 관리 하는 데 사용 되는 고유 문자열 식별자입니다.

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

반환 값

형식: uint32

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

반환 코드/값 Description
S _ 확인
0 (0x0)
메서드를 성공적으로 수행했습니다.
E _ INVALIDARG
2147942487 (0x80070057)
Externalkey 매개 변수가 제공 되었지만 크기 4의 배열이 아닙니다.
Fve _ E _ 잠김 _ 볼륨
2150694912 (0x80310000)
볼륨이 잠겼습니다.
Fve _ E _ _ 활성화 되지 않음
2150694920 (0x80310008)
BitLocker가 볼륨에서 활성화되지 않았습니다. BitLocker를 사용 하도록 설정 하려면 키 보호기를 추가 합니다.

설명

MOF (MOF(Managed Object Format)) 파일에는 WMI (WMI(Windows Management Instrumentation)) 클래스에 대 한 정의가 포함 되어 있습니다. MOF 파일은 Windows SDK 일부로 설치 되지 않습니다. 서버 관리자를 사용 하 여 연결 된 역할을 추가할 때 서버에 설치 됩니다. MOF 파일에 대 한 자세한 내용은 mof (MOF(Managed Object Format))를 참조 하세요.

요구 사항

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

참고 항목

Win32 _ EncryptableVolume