Método IVMVirtualMachine::GetActivationValue

[O Pc Virtual do Windows não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Recupera o valor da configuração de ativação especificada para essa máquina virtual.

Sintaxe

HRESULT GetActivationValue(
  [in]          BSTR    activationKey,
  [out, retval] VARIANT *activationValue
);

Parâmetros

activationKey [in]

A chave usada para identificar o valor de ativação como armazenado no arquivo "*.vmc".

activationValue [out, retval]

O valor de ativação. Esse valor pode ser um dos seguintes tipos VARIANT : VT_ARRAY | VT_UI1 (bytes brutos), VT_BSTR (cadeia de caracteres), VT_I4 (inteiro) ou VT_BOOL (booliano).

Valor retornado

Esse método pode retornar um desses valores.

Código/valor de retorno	Descrição
S_OK 0	A operação foi bem-sucedida.
E_INVALIDARG 0x80000003	O parâmetro activationKey é NULL ou vazio.
E_POINTER 0x80004003	O parâmetro activationValue é NULL.
VM_E_VM_UNKNOWN 0xA0040207	A configuração é desconhecida.
VM_E_PREF_NOT_FOUND 0xA0040300	A preferência não foi encontrada ou essa configuração não tem ativação válida.
DISP_E_EXCEPTION 0x80020009	Ocorreu um erro inesperado.

Comentários

Esse método fornece acesso de baixo nível a qualquer valor de ativação. Ele pode ser usado para definir valores de ativação para chaves definidas pelo cliente. Quando uma máquina virtual é iniciada, uma cópia é feita de seus valores de configuração, que se torna seu conjunto de valores de ativação. Os valores de ativação são mantidos até que a máquina virtual seja desligada ou reiniciada. Observe que o Pc Virtual do Windows só pode usar a configuração para armazenar valores para determinadas chaves, ou seja, o valor de ativação pode nunca ser usado.

As chaves de ativação são armazenadas internamente de maneira hierárquica semelhante às chaves do Registro no Windows. Para especificar uma subchave específica, é construído um "caminho de chave" que especifica as várias chaves em um formato delimitado por marca de barra.

Por exemplo, para ler o valor da chave "default_action" localizada na seguinte árvore de chaves:

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

A cadeia de caracteres de caminho activationKey seria especificada da seguinte maneira:

"settings/undo_drives/default_action"

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Fim do suporte ao cliente	Windows 7
Produto	Windows Virtual PC
Cabeçalho	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Confira também

IVMVirtualMachine