Win32_EncryptableVolume 클래스의 UnlockWithCertificateThumbprint 메서드

Win32_EncryptableVolume 클래스의 UnlockWithCertificateThumbprint 메서드는 제공된 인증서 지문을 사용하여 파생 키를 가져오고 암호화된 볼륨의 잠금을 해제합니다.

참고

디스크가 하드웨어 암호화를 지원하는 경우 이 함수는 밴드 상태 "잠금 해제됨"으로 설정합니다.

구문

uint32 UnlockWithCertificateThumbprint(
  [in] string CertThumbprint,
  [in] string PIN
);

CertThumbprint [in]

형식: 문자열

지문 값이 0이면 로컬 저장소에서 적절한 인증서를 검색합니다. 단일 BitLocker 인증서가 발견되면 검색에 성공합니다. 인증서가 하나 이상 없으면 메서드가 실패합니다.

PIN [in]

형식: 문자열

사용자가 지정한 개인 식별 문자열입니다. 이 문자열은 4~20자리의 시퀀스로 구성되어야 합니다. 이 문자열은 스마트 카드 사용할 때 KSP(키 스토리지 공급자)를 자동으로 인증하는 데 사용됩니다.

형식: uint32

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

반환 코드/값	Description
S_OK 0(0x0)	메서드를 성공적으로 수행했습니다.
FVE_E_NOT_ACTIVATED 2150694920(0x80310008)	BitLocker가 볼륨에서 활성화되지 않았습니다. BitLocker를 사용하도록 설정하는 키 보호기를 추가합니다.
FVE_E_FAILED_AUTHENTICATION 2150694951(0x80310027)	제공된 정보를 사용하여 볼륨의 잠금을 해제할 수 없습니다.
FVE_E_PROTECTOR_NOT_FOUND 2150694963(0x80310033)	제공된 키 보호기가 볼륨에 없습니다. 다른 키 보호기를 입력해야 합니다.
FVE_E_PRIVATEKEY_AUTH_FAILED 2150695060(0x80310094)	지정된 인증서와 연결된 프라이빗 키를 인증할 수 없습니다. 프라이빗 키 권한 부여가 제공되지 않았거나 제공된 권한 부여가 잘못되었습니다.

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