IVMVirtualMachine::RemoveActivationValue 메서드

  • 아티클

[Windows 가상 PC는 Windows 8 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]

이 가상 머신에 대해 지정된 활성화 설정의 값을 제거합니다.

구문

HRESULT RemoveActivationValue(
  [in] BSTR activationKey
);

매개 변수

activationKey [in]

"*.vmc" 파일에 저장된 활성화 값을 식별하는 데 사용되는 키입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드/값 Description
S_OK
0
 작업이 완료되었습니다.
E_INVALIDARG
0x80000003
 매개 변수가 NULL 이거나 비어 있습니다.
VM_E_VM_UNKNOWN
0xA0040207
 구성을 알 수 없습니다.
VM_E_PREF_NOT_FOUND
0xA0040300
 기본 설정을 찾을 수 없거나 이 구성에 유효한 활성화가 없습니다.
DISP_E_EXCEPTION
0x80020009
 예기치 않은 오류가 발생했습니다.

설명

이 메서드는 모든 활성화 값에 대한 낮은 수준의 액세스를 제공합니다. 고객 정의 키에 대한 활성화 값을 제거하는 데 사용할 수 있습니다. 가상 머신이 실행되는 동안 일부 값을 변경할 수 없으므로 이 메서드를 사용하여 시스템 활성화 값을 제거하는 경우 주의해야 합니다. 가상 머신이 시작되면 복사본은 해당 구성 값으로 만들어지며, 이 값은 활성화 값 집합이 됩니다. 활성화 값은 가상 머신이 종료되거나 다시 시작될 때까지 유지됩니다. Windows 가상 PC는 구성을 사용하여 특정 키에 대한 값만 저장할 수 있습니다. 즉, 정품 인증 값은 사용할 수 없습니다.

참고

활성화 값을 변경하려면 가상 머신 세션을 실행해야 합니다.

정품 인증 키는 Windows의 레지스트리 키와 유사한 계층적 방식으로 내부적으로 저장됩니다. 특정 하위 키를 지정하기 위해 슬래시 표시로 구분된 형식으로 다양한 키를 지정하는 "키 경로"가 생성됩니다.

예를 들어 다음 키 트리에 있는 "default_action" 키의 값을 제거하려면 다음을 수행합니다.

<settings>
    <undo_drives>
        <default_action type="integer">1</default_action>

activationKey 경로 문자열은 다음과 같이 지정됩니다.

"settings/undo_drives/default_action"

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
클라이언트 지원 종료
 Windows 7
제품
 Windows Virtual PC
헤더
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine f7092aa1-33ed-4f78-a59f-c00adfc2edd7로 정의됩니다.

추가 정보

IVMVirtualMachine