Método IVMVirtualPC::GetHardDisk

[Windows Computador Virtual 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 um objeto correspondente a um arquivo de imagem de disco existente.

Sintaxe

HRESULT GetHardDisk(
  [in]          BSTR        imagePath,
  [out, retval] IVMHardDisk **hardDisk
);

Parâmetros

imagePath [in]

O caminho completo para um arquivo de imagem de disco existente.

hardDisk [out, retval]

Um objeto IVMHardDisk correspondente a esta imagem de disco.

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_POINTER
0x80004003
O parâmetro imagePath ou hardDisk é NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
O sistema não pode localizar o arquivo especificado pelo parâmetro imagePath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
O sistema não pode encontrar o caminho especificado pelo parâmetro imagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
O parâmetro imagePath contém um caractere inválido (um de "*?:<>/|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
O parâmetro imagePath especifica um caminho vazio ou relativo. Um caminho absoluto é necessário.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
O caminho especificado pelo parâmetro imagePath é muito longo. O comprimento do caminho deve ter menos de 260 caracteres.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
O processador não dá suporte a extensões HAV (Virtualização Acelerada por Hardware).

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