Bagikan melalui

Metode IVMGuestOS::SetParameter

  • Artikel

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

Mengatur parameter bernama dalam sistem operasi tamu.

Sintaks

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

Parameter

inParameterName [in]

Nama parameternya. Panjangnya harus antara 1 dan 255 karakter dan tidak boleh berisi karakter garis miring terbalik (\).

inParameterValue [in]

Nilai parameternya.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0
 Operasi berhasil.
E_INVALIDARG
0x80000003
 Parameter tidak valid atau tidak ditentukan.
VM_E_TIMED_OUT
0xA0040202
 Operasi tidak selesai tepat waktu.
VM_E_VM_NOT_RUNNING
0xA0040206
 Komputer virtual (VM) tidak berjalan.
VM_E_VM_PAUSED
0xA00400507
 VM dijeda.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Komponen integrasi tidak diinstal di VM ini.
DISP_E_EXCEPTION
0x80020009
 Terjadi kesalahan tidak terduga.

Keterangan

VM harus berjalan dan komponen integrasi harus diinstal ketika metode ini dipanggil. Metode ini hanya didukung untuk sistem operasi tamu berbasis Windows.

Dengan komponen integrasi terinstal, kunci berikut secara otomatis ditambahkan ke registri sistem operasi tamu:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

Saat sistem operasi tamu dimulai, nilai string registri berikut diisi dalam kunci Parameter :

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

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_IVMGuestOS didefinisikan sebagai 99fea0db-4880-499a-b6d8-73dff9bc91be

Lihat juga

IVMGuestOS