Método IVMVirtualPC::CreateDifferencingVirtualHardDisk

[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 diferente.

Sintaxe

HRESULT CreateDifferencingVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          BSTR    parentPath,
  [out, retval] IVMTask **diskTask
);

Parâmetros

imagePath [in]

O caminho para o novo arquivo de imagem de disco. A pasta que contém será criada se ela não existir.

parentPath [in]

O caminho para o arquivo de imagem de disco pai.

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.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	O sistema não pode encontrar o caminho especificado pelo parâmetro imagePath ou parentPath .
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 ou parentPath contém um caractere inválido (um de "*?:<>/|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	O parâmetro imagePath e parentPath 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 pelos parâmetros imagePath ou parentPath é muito longo. O comprimento do caminho deve ter menos de 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 tamanho do parâmetro deve ser inferior a 2.088.960 MB. Se o formato for FAT16, o tamanho 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 poderá dar suporte a um arquivo desse tamanho se a imagem de disco rígido virtual em expansão dinâmica se expandir para seu limite total. 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.

Comentários

Embora imagePath ou parentPath possa ser um caminho relativo, pelo menos um deles deve ser um caminho absoluto. Se um parâmetro de caminho for um caminho relativo, supõe-se que ele seja relativo ao outro parâmetro de caminho.

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