Método IVMVirtualPC::GetConfigurationValue

  • Artigo

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

Recupera o valor da definição de configuração especificada.

Sintaxe

HRESULT GetConfigurationValue(
  [in]          BSTR    preferenceKey,
  [out, retval] VARIANT *preferenceValue
);

Parâmetros

preferenceKey [in]

A chave usada para identificar a preferência, conforme armazenado no arquivo de configuração.

preferenceValue [out, retval]

O valor de preferência. Esse parâmetro 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.

Retornar código/valor Descrição
S_OK
0
 A operação foi bem-sucedida.
E_POINTER
0x80004003
 O parâmetro preferenceKey ou preferenceValue é NULL.
VM_E_PREF_NOT_FOUND
0xa0040300
 A preferência não foi encontrada.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 O processador não dá suporte a extensões HAV (Virtualização Acelerada por Hardware).
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.

Comentários

Esse método fornece acesso de baixo nível a qualquer valor de preferência para o usuário atual. Ele pode ser usado para recuperar valores de preferência para chaves definidas pelo cliente.

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_IVMVirtualPC é definido como 236ba0d9-a24a-4292-a132-27c1421dfd01

Confira também

IVMVirtualPC