Método IVMVirtualMachine::RemoveActivationValue
[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).]
Remove o valor da configuração de ativação especificada para esta máquina virtual.
Sintaxe
HRESULT RemoveActivationValue(
[in] BSTR activationKey
);
Parâmetros
-
activationKey [in]
-
A chave usada para identificar o valor de ativação como armazenado no arquivo "*.vmc".
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 é NULL ou vazio. |
|
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 remover valores de ativação para chaves definidas pelo cliente. Tenha cuidado se você usar esse método para remover valores de ativação do sistema, pois alguns valores 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 qualquer valor de ativação possa ser alterado.
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 remover 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 |