Método IVMHardDisk::MergeTo

Artigo
06/13/2023

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

Mescla um disco rígido virtual diferente com todos os seus pais (até e incluindo o disco rígido virtual pai raiz) para um novo arquivo de disco rígido.

Sintaxe

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

Parâmetros

newDiskImagePath [in]: O caminho para a nova imagem de disco de destino em que as imagens de disco selecionadas serão mescladas.
newDiskImageType [in]: O tipo de nova imagem de disco de destino. Os tipos de imagem permitidos para a nova imagem de disco de destino são vmDiskType_Dynamic e vmDiskType_FixedSize. Para obter mais informações, consulte VMHardDiskType.
mergeTask [out, retval]: Um objeto IVMTask usado para acompanhar a conclusão do processo de mesclagem.

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	Um parâmetro é NULL.
E_INVALIDARG 0x80000003	O parâmetro newDiskImagePath está vazio.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	O sistema não pode localizar o arquivo especificado pelo parâmetro newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	O sistema não pode localizar o caminho especificado pelo parâmetro newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	O parâmetro newDiskImagePath contém um caractere inválido (um dos seguintes: "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	O parâmetro newDiskImagePath especifica um caminho vazio ou relativo. Um caminho absoluto é necessário.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	O caminho especificado pelo parâmetro newDiskImagePath é muito longo. O caminho deve ter menos de 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.
VM_E_WRONG_HD_IMAGE_TYPE 0xA004067B	Esse erro é causado porque a imagem de disco rígido virtual referenciada por esse objeto IVMHardDisk não é uma imagem de disco diferente ou porque o parâmetro newDiskImageType não é um dos valores aceitos, vmDiskType_Dynamic ou vmDiskType_FixedSize.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	O arquivo referenciado pelo parâmetro newDiskImagePath já existe.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	O volume do host não tem espaço suficiente para mesclar esse disco rígido virtual.
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 mesclada porque o aplicativo está sendo desligado.
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_IVMHardDisk é definido como ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Confira também

IVMHardDisk

Compartilhar via