Metode IVMVirtualMachine::AddHardDiskConnection

  • Artikel

[Windows Virtual PC tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan penyedia Hyper-V WMI (V2).]

Menambahkan koneksi hard disk baru ke komputer virtual (VM).

Sintaks

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

Parameter

hardDiskPath [in]

Jalur lengkap file hard disk virtual (VHD) untuk disambungkan.

busNumber [in]

Bus tempat drive akan terpasang.

Nilai Makna
0
 Drive akan dilampirkan ke bus pertama.
1
 Drive akan dilampirkan ke bus kedua.

deviceNumber [in]

Perangkat tempat drive akan dilampirkan.

Nilai Makna
0
 Drive akan dilampirkan ke perangkat pertama di bus.
1
 Drive akan dilampirkan ke perangkat kedua pada bus.

hardDiskConnection [out, retval]

Objek IVMHardDiskConnection .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0
 Operasi berhasil.
E_POINTER
0x80004003
 Parameter hardDiskConnection adalah NULL.
E_INVALIDARG
0x80000003
 Parameter hardDiskPath adalah NULL atau parameter busNumber atau deviceNumber tidak valid.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Sistem tidak dapat menemukan file yang ditentukan oleh parameter hardDiskPath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Sistem tidak dapat menemukan jalur yang ditentukan oleh parameter hardDiskPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Parameter hardDiskPath berisi karakter yang tidak valid (salah satu dari "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Parameter hardDiskPath menentukan jalur kosong atau relatif. Jalur absolut diperlukan.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Jalur yang ditentukan oleh parameter hardDiskPath terlalu panjang. Jalur harus kurang dari 260 karakter.
VM_E_VM_UNKNOWN
0xA0040207
 Konfigurasi tidak diketahui.
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
 VM dalam status berjalan atau disimpan.
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
 Lokasi bus yang ditentukan sedang digunakan.
VM_E_INVALID_HD_FILE
0xA0040682
 VHD lebih besar dari 127 GB dan tidak dapat dihubungkan ke bus IDE.
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
 Parameter hardDiskPath mengacu pada VHD yang ditautkan atau VHD yang berbeda dengan VHD yang ditautkan. VHD tertaut tidak dapat dilampirkan ke komputer virtual.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 VHD yang ditentukan sudah tersambung ke lokasi bus lain untuk VM ini.
DISP_E_EXCEPTION
0x80020009
 Terjadi kesalahan tidak terduga.

Keterangan

Anda hanya dapat menambahkan koneksi hard disk baru ke komputer virtual yang dihentikan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung
 Tidak ada yang didukung
Akhir dukungan klien
 Windows 7
Produk
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine didefinisikan sebagai f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Lihat juga

IVMVirtualMachine