Win32_EncryptableVolume 클래스의 ChangePIN 메서드

  • 아티클

Win32_EncryptableVolume 클래스의 ChangePIN 메서드는 암호화된 볼륨과 연결된 PIN을 변경합니다. "시작에 향상된 PIN 허용" 그룹 정책을 사용하는 경우 PIN에는 숫자 외에 문자, 기호 및 공백이 포함될 수 있습니다.

구문

uint32 ChangePIN(
  [in] string VolumeKeyProtectorID,
  [in] string NewPIN
);

매개 변수

VolumeKeyProtectorID [in]

형식: 문자열

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

NewPIN [in]

형식: 문자열

사용자가 지정한 개인 식별 문자열입니다. 이 문자열은 4~20자리의 시퀀스로 구성되어야 합니다. 또는 "시작에 향상된 PIN 허용" 그룹 정책을 사용하는 경우 4~20자, 기호, 공백 또는 숫자로 구성되어야 합니다.

반환 값

형식: uint32

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

반환 코드/값 Description
S_OK
0(0x0)
 메서드를 성공적으로 수행했습니다.
FVE_E_BOOTABLE_CDDVD
2150694960(0x80310030)
 이 컴퓨터에서 부팅 가능한 CD/DVD를 찾을 수 있습니다. CD/DVD를 제거하고 컴퓨터를 다시 시작합니다.
FVE_E_INVALID_PIN_CHARS
2150695066(0x8031009A)
 NewPIN 매개 변수에는 유효하지 않은 문자가 포함되어 있습니다. "시작에 향상된 PIN 허용" 그룹 정책 사용하지 않도록 설정되면 숫자만 지원됩니다.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970(0x8031003A)
 VolumeKeyProtectorID 매개 변수는 "숫자 암호" 또는 "외부 키" 형식의 키 보호기를 참조하지 않습니다. ProtectKeyWithNumericalPassword 또는 ProtectKeyWithExternalKey 메서드를 사용하여 적절한 형식의 키 보호기를 만듭니다.
FVE_E_LOCKED_VOLUME
2150694912(0x80310000)
 볼륨이 잠겨 있습니다.
FVE_E_NOT_ACTIVATED
2150694920(0x80310008)
 BitLocker가 볼륨에서 활성화되지 않았습니다. BitLocker를 사용하도록 설정하는 키 보호기를 추가합니다.
FVE_E_POLICY_INVALID_PIN_LENGTH
2150695016(0x80310068)
 제공된 NewPIN 매개 변수는 20자보다 길거나, 4자보다 짧거나, 그룹 정책 지정한 최소 길이보다 짧습니다.
FVE_E_PROTECTOR_NOT_FOUND
2150694963(0x80310033)
 제공된 키 보호기가 볼륨에 없습니다.
TBS_E_SERVICE_NOT_RUNNING
2150121480(0x80284008)
 이 컴퓨터에서 호환되는 TPM(신뢰할 수 있는 플랫폼 모듈)을 찾을 수 없습니다.

 

설명

ChangePIN 메서드는 기존 보호기 정보 및 새로 제공된 PIN을 기반으로 새 TPM 및 PIN 보호기를 만듭니다. 새 보호기는 동일한 GUID를 갖습니다. ChangePIN 메서드를 호출하여 PIN을 사용하는 키 보호기의 PIN을 변경할 수도 있습니다(예: PIN 및 USB가 있는 TPM 및 PIN 또는 TPM).

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

요구 사항

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

추가 정보

Win32_EncryptableVolume