Metode IVMVirtualPC::CreateVirtualMachine

Artikel
06/13/2023

[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

Bagikan melalui