Método IVMVirtualMachine::SetActivationValue

[O Computador 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).]

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

Sintaxe

HRESULT SetActivationValue(
  [in] BSTR    activationKey,
  [in] VARIANT activationValue
);

Parâmetros

activationKey [in]

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

activationValue [in]

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_UI4 (inteiro) ou VT_BOOL (booliano).

Valor retornado

Esse método pode retornar um desses valores.

Retornar código/valor	Descrição
S_OK 0	A operação foi bem-sucedida.
E_INVALIDARG 0x80000003	O parâmetro activationKey é NULL ou vazio, ou o parâmetro activationValue não é um tipo variante válido.
VM_E_VM_UNKNOWN 0xA0040207	A configuração é desconhecida.
VM_E_PREF_NOT_FOUND 0xA0040300	A 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. Tenha cuidado se você usar esse método para definir valores de ativação do sistema, pois nenhuma verificação de erro é executada no valor de ativação. Além disso, alguns valores de ativação não podem ser alterados enquanto a máquina virtual está em execução. 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.

Observação

A sessão da máquina virtual deve estar em execução antes que os valores de ativação possam ser alterados.

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 definir 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