Compartilhar via


Método IVMVirtualMachine::AddHardDiskConnection

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

Adiciona uma nova conexão de disco rígido à VM (máquina virtual).

Sintaxe

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

Parâmetros

hardDiskPath [in]

O caminho completo do arquivo VHD (disco rígido virtual) a ser conectado.

busNumber [in]

O ônibus ao qual a unidade será anexada.

Valor Significado
0
A unidade será anexada ao primeiro ônibus.
1
A unidade será anexada ao segundo ônibus.

deviceNumber [in]

O dispositivo ao qual a unidade será anexada.

Valor Significado
0
A unidade será anexada ao primeiro dispositivo no barramento.
1
A unidade será anexada ao segundo dispositivo no barramento.

hardDiskConnection [out, retval]

Um objeto IVMHardDiskConnection .

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
O parâmetro hardDiskConnection é NULL.
E_INVALIDARG
0x80000003
Um parâmetro hardDiskPath é NULL ou o parâmetro busNumber ou deviceNumber não é válido.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
O sistema não pode encontrar o arquivo especificado pelo parâmetro hardDiskPath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
O sistema não pode encontrar o caminho especificado pelo parâmetro hardDiskPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
O parâmetro hardDiskPath contém um caractere inválido (um de "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
O parâmetro hardDiskPath especifica um caminho vazio ou relativo. Um caminho absoluto é necessário.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
O caminho especificado pelo parâmetro hardDiskPath é muito longo. O caminho deve ter menos de 260 caracteres.
VM_E_VM_UNKNOWN
0xA0040207
A configuração é desconhecida.
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
A VM está em um estado em execução ou salvo.
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
O local do barramento especificado está em uso.
VM_E_INVALID_HD_FILE
0xA0040682
O VHD é maior que 127 GB e não pode ser conectado ao barramento IDE.
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
O parâmetro hardDiskPath refere-se a um VHD vinculado ou a um VHD diferente de um VHD vinculado. VHDs vinculados não podem ser anexados a máquinas virtuais.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
O VHD especificado já está conectado a outro local de barramento para essa VM.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.

Comentários

Você só pode adicionar uma nova conexão de disco rígido a uma máquina virtual interrompida.

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_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Confira também

IVMVirtualMachine