IVMVirtualMachine::GetActivationValue 메서드
[Windows 가상 PC는 Windows 8 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]
이 가상 머신에 대해 지정된 활성화 설정의 값을 검색합니다.
구문
HRESULT GetActivationValue(
[in] BSTR activationKey,
[out, retval] VARIANT *activationValue
);
매개 변수
-
activationKey [in]
-
"*.vmc" 파일에 저장된 활성화 값을 식별하는 데 사용되는 키입니다.
-
activationValue [out, retval]
-
활성화 값입니다. 이 값은VT_ARRAY VT_UI1(원시 바이트), VT_BSTR | (문자열), VT_I4(정수) 또는 VT_BOOL(부울) 형식 중 하나일 수 있습니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드/값 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
activationKey 매개 변수가 NULL이거나 비어 있습니다. |
|
activationValue 매개 변수는 NULL입니다. |
|
구성을 알 수 없습니다. |
|
기본 설정을 찾을 수 없거나 이 구성에 유효한 활성화가 없습니다. |
|
예기치 않은 오류가 발생했습니다. |
설명
이 메서드는 모든 활성화 값에 대한 낮은 수준의 액세스를 제공합니다. 고객 정의 키에 대한 활성화 값을 설정하는 데 사용할 수 있습니다. 가상 머신이 시작되면 복사본은 해당 구성 값으로 만들어지며, 이 값은 활성화 값 집합이 됩니다. 활성화 값은 가상 머신이 종료되거나 다시 시작될 때까지 유지됩니다. 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 |
| 헤더 |
|
| IID |
IID_IVMVirtualMachine f7092aa1-33ed-4f78-a59f-c00adfc2edd7로 정의됩니다. |