Compartilhar via


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