Método IVMVirtualPC::CreateFixedVirtualHardDisk

Artigo
06/13/2023

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

Cria um disco rígido virtual de tamanho fixo.

Sintaxe

HRESULT CreateFixedVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          long    size,
  [out, retval] IVMTask **diskTask
);

Parâmetros

imagePath [in]: O caminho completo para o novo arquivo de imagem de disco. A pasta que contém será criada se ela não existir.
size [in]: O tamanho, em megabytes, da imagem. O tamanho máximo é de 2.088.960 MB (2040 GB).
diskTask [out, retval]: Um objeto IVMTask usado para acompanhar a criação da imagem.

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	Um parâmetro é NULL.
E_INVALIDARG 0x80000003	O parâmetro size é menor ou igual a 0.
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_DRIVE) 0x8007000f	O arquivo especificado pelo parâmetro imagePath está em um CD-ROM ou DVD-ROM.
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. Pelo menos um dos parâmetros deve ser um caminho absoluto.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	O caminho especificado pelo parâmetro imagePath é muito longo. O comprimento do caminho deve ser menor que MAX_PATH (260) caracteres.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	O arquivo referenciado pelo parâmetro imagePath já existe.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	A imagem de disco rígido virtual em expansão dinâmica precisa de pelo menos 8 MB livres no volume do host.
VM_E_IMAGE_SIZE_TOO_LARGE 0xA0040683	O parâmetro size deve ter menos de 2.088.960 MB. Se o formato for FAT16, o parâmetro size deverá ser menor que 2000 MB.
VM_E_IMAGE_SIZE_TOO_SMALL 0xA0040684	As imagens de disco rígido virtual formatadas em FAT16 e não formatadas devem ter pelo menos 3 MB. As imagens de disco rígido virtual formatadas em FAT32 devem ter pelo menos 514 MB.
VM_E_FILE_TOO_LARGE_FOR_VOLUME 0xA0040679	O volume do host não pode dar suporte a um arquivo desse tamanho. O tamanho máximo do arquivo para um volume FAT32 é de 4 GB. O tamanho máximo do arquivo para um volume FAT16 é de 2 GB.
VM_E_APP_SHUTTING_DOWN 0xA0040209	O disco rígido virtual não pode ser criado depois que o aplicativo começar a desligar.
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.

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

Compartilhar via