Properti IVMVirtualMachine::Name

  • Artikel

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

Mengambil dan mengatur nama konfigurasi komputer virtual.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

HRESULT get_Name(
  [out, retval] BSTR *virtualMachineName
);

Nilai properti

Menentukan nama konfigurasi komputer virtual. Panjang nama tidak boleh lebih dari 80 karakter dan panjang total jalur yang sepenuhnya memenuhi syarat yang menyertakan file konfigurasi nama komputer virtual tidak boleh lebih dari MAX_PATH (260) karakter.

Kode kesalahan

Nama/nilai Makna
S_OK
0
 Operasi berhasil.
E_POINTER
0x80004003
 Parameternya adalah NULL.
E_INVALIDARG
0x80000003
 Parameter tidak valid atau merupakan string kosong.
VM_E_VM_UNKNOWN
0xA0040207
 Konfigurasi tidak diketahui.
VM_E_PREF_VM_ACTIVE
0xA0040302
 Komputer virtual sedang berjalan atau disimpan.
VM_E_CONFIG_NO_NAME
0xA0040400
 Parameter virtualMachineName kosong.
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
 Parameter berisi terlalu banyak karakter.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 Parameter berisi salah satu karakter tidak valid berikut "*?:<>/|\"".
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 Nama yang ditentukan sudah ada sebagai nama komputer virtual lain.
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. Ini adalah properti default untuk IVMVirtualMachine.

Jika VPC.exe berjalan dan VM disimpan, maka pengaturan properti Nama tidak akan berhasil. Jika VPC.exe tidak berjalan dan VM disimpan, maka pengaturan properti Nama akan berhasil ketika VPC.exe dimulai berikutnya.

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