Metode IVMVirtualPC::RegisterVirtualMachine

  • Artikel

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

Mendaftarkan konfigurasi komputer virtual yang ada dan mengambil objek komputer virtual.

Sintaks

HRESULT RegisterVirtualMachine(
  [in]          BSTR              configurationName,
  [in]          BSTR              configurationPath,
  [out, retval] IVMVirtualMachine **virtualMachine
);

Parameter

configurationName [in]

Nama komputer virtual yang akan didaftarkan. Panjang nama tidak boleh melebihi 80 karakter dan panjang gabungan nama dan jalur tidak boleh melebihi MAX_PATH (260) karakter. Nama yang ditentukan mungkin berisi ekstensi .vmc. Jika parameter ini NULL atau string kosong, parameter configurationPath harus menentukan jalur lengkap ke file konfigurasi.

configurationPath [in]

Jalur ke folder yang berisi file konfigurasi yang ada. Jika parameter configurationNameadalah NULL atau string kosong, ini harus menentukan jalur lengkap ke file konfigurasi yang ada.

virtualMachine [out, retval]

Penunjuk ke objek IVMVirtualMachine baru yang mewakili komputer virtual ini.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0
 Operasi berhasil.
E_POINTER
0x80004003
 Parameter configurationName atau configurationPath tidak valid, atau virtualMachine adalah NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Sistem tidak dapat menemukan jalur yang ditentukan oleh parameter configurationName dan configurationPath .
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Sistem tidak dapat menemukan file yang ditentukan oleh parameter configurationName dan configurationPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Parameter configurationPath berisi karakter yang tidak valid (salah satu dari "*?:<>/|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Parameter parameter configurationPath menentukan jalur kosong atau relatif. Jalur absolut diperlukan.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Jalur yang ditentukan oleh parameter configurationName dan configurationPath menghasilkan jalur yang terlalu panjang. Panjang gabungan jalur harus kurang dari MAX_PATH (260) karakter.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 File konfigurasi dengan nama ini sudah ada di lokasi ini.
VM_E_CONFIG_NAME_TOO_LONG
0xA0040401
 Panjang parameter configurationName melebihi 80 karakter.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 Parameter configurationName berisi karakter yang tidak valid (salah satu dari "*?:<>/|\"").
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 Sudah ada komputer virtual dengan nama ini.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Prosesor tidak mendukung ekstensi Hardware Accelerated Virtualization (HAV).
DISP_E_EXCEPTION
0x80020009
 Terjadi kesalahan tidak terduga.

Keterangan

Nama komputer virtual tidak peka huruf besar/kecil, misalnya, "MyVM" dan "myvm" mengacu pada komputer virtual yang sama.

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_IVMVirtualPC didefinisikan sebagai 236ba0d9-a24a-4292-a132-27c1421dfd01

Lihat juga

IVMVirtualPC