Partilhar via

Método IVMGuestOS::SetParameter

  • Artigo

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

Define um parâmetro nomeado dentro do sistema operacional convidado.

Sintaxe

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

Parâmetros

inParameterName [in]

O nome do parâmetro. Ele deve ter entre 1 e 255 caracteres e não pode conter um caractere de barra invertida (\).

inParameterValue [in]

O valor do parâmetro.

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
 Um parâmetro não é válido ou não é especificado.
VM_E_TIMED_OUT
0xA0040202
 A operação não foi concluída em tempo hábil.
VM_E_VM_NOT_RUNNING
0xA0040206
 A VM (máquina virtual) não está em execução.
VM_E_VM_PAUSED
0xA00400507
 A VM está em pausa.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Os componentes de integração não estão instalados nesta VM.
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.

Comentários

A VM deve estar em execução e os componentes de integração devem ser instalados quando esse método é invocado. Esse método só tem suporte para sistemas operacionais convidados baseados no Windows.

Com os componentes de integração instalados, a seguinte chave é adicionada automaticamente ao registro do sistema operacional convidado:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

Quando o sistema operacional convidado é iniciado, os seguintes valores de cadeia de caracteres do Registro são preenchidos na chave Parâmetros :

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

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_IVMGuestOS é definido como 99fea0db-4880-499a-b6d8-73dff9bc91be

Confira também

IVMGuestOS