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 |
|---|---|
|
A operação foi bem-sucedida. |
|
O parâmetro activationKey é NULL ou vazio. |
|
O parâmetro activationValue é NULL. |
|
A configuração é desconhecida. |
|
A preferência não foi encontrada ou essa configuração não tem ativação válida. |
|
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 |
|
| IID |
IID_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |