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 및 PIN 또는 PIN 및 USB가 있는 TPM)을 변경할 수도 있습니다.

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

요구 사항

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

추가 정보

Win32_EncryptableVolume