Método IVMHardDisk::Convert

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

Converte um disco rígido virtual de tamanho fixo em um disco rígido virtual em expansão dinâmica ou converte um disco rígido virtual em expansão dinâmica em um disco rígido virtual de tamanho fixo.

Sintaxe

HRESULT Convert(
  [in]          BSTR           convertedDiskImagePath,
  [in]          VMHardDiskType convertedDiskImageType,
  [out, retval] IVMTask        **convertTask
);

Parâmetros

convertDiskImagePath [in]

O caminho para o arquivo de imagem de disco de destino.

convertDiskImageType [in]

O tipo da imagem de disco de destino. Para obter uma lista de valores, consulte VMHardDiskType.

convertTask [out, retval]

Um objeto IVMTask usado para acompanhar a conclusão do processo de conversão.

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_INVALIDARG 0x80000003	O parâmetro convertDiskImagePath está vazio ou não tem a extensão .vhd no nome do arquivo.
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 convertDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	O parâmetro convertDiskImagePath contém um caractere inválido (um de "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	O parâmetro convertDiskImagePath especifica um caminho vazio ou relativo. Um caminho absoluto é necessário.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	O caminho especificado pelo parâmetro convertDiskImagePath é muito longo. O caminho deve ter menos de MAX_PATH (260) caracteres.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) 0x80070020	O disco rígido virtual referenciado por esse objeto está em uso ou o pai desse disco rígido virtual está em uso.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	O volume do host não tem espaço suficiente para converter esse disco rígido virtual.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	O arquivo referenciado pelo parâmetro convertDiskImagePath já existe.
VM_E_WRONG_HD_IMAGE_TYPE 0xA004067B	O parâmetro convertDiskImagePath deve ser vmDiskType_Dynamic ou vmDiskType_FixedSize.
VM_E_INVALID_HD_FILE 0xA0040682	A imagem de disco rígido virtual referenciada por esse objeto IVMHardDisk não parece ser uma imagem válida.
VM_E_PARENT_PATH_NOT_FOUND 0xA0040677	O pai do disco rígido virtual referenciado por esse objeto não existe.
VM_E_APP_SHUTTING_DOWN 0xA0040209	A imagem de disco rígido virtual não pode ser convertida porque o aplicativo está sendo desligado.
DISP_E_EXCEPTION 0x80020009	Ocorreu um erro inesperado.

Comentários

O arquivo de origem é deixado intacto após o processo de conversão.

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_IVMHardDisk é definido como ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Confira também

IVMHardDisk