Metode IVMVirtualPC::CreateVirtualMachine

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

Membuat konfigurasi komputer virtual baru dan mengambil objek komputer virtual.

Sintaks

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

Parameter

configurationName [in]

Nama komputer virtual yang akan dibuat. Panjang nama tidak boleh melebihi 80 karakter dan panjang gabungan nama dan jalur ke file VMC dan VMCX tidak boleh melebihi MAX_PATH (260) karakter. Ekstensi nama file .vmc dan .vmcx akan ditambahkan ke akhir nama komputer virtual saat file konfigurasi dibuat. Jika parameter ini adalah NULL atau string kosong, parameter configurationPath harus menentukan jalur lengkap ke file VMC.

configurationPath [in]

Jalur ke folder yang akan berisi file VMC. Folder ini akan dibuat jika tidak ada. Jika configurationName adalah NULL atau string kosong, ini harus menentukan jalur lengkap file konfigurasi baru.

virtualMachine [out, retval]

Penunjuk ke objek IVMVirtualMachine baru yang mewakili komputer virtual ini.

Menampilkan 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 parameter virtualMachine adalah NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
Sistem tidak dapat menemukan jalur yang ditentukan oleh parameter 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 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 total 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_NO_NAME
0xA0040400
Parameter configurationName kosong.
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" merujuk ke 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