Bagikan melalui

Metode IVMGuestOS::GetParameter

  • Artikel

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

Mengambil parameter bernama dalam sistem operasi tamu.

Sintaks

HRESULT GetParameter(
  [in]          BSTR inParameterName,
  [out, retval] BSTR *outParameterValue
);

Parameter

inParameterName [in]

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

outParameterValue [out, retval]

Nilai parameternya.

Mengembalikan 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.
E_POINTER
0x80004003
 Parameternya adalah NULL.
VM_E_TIMED_OUT
0xA0040202
 Operasi tidak selesai tepat waktu.
VM_E_VM_NOT_RUNNING
0xA0040206
 Komputer virtual tidak berjalan.
VM_E_VM_PAUSED
0xA00400507
 Komputer virtual dijeda.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Komponen integrasi tidak diinstal di komputer virtual ini.
DISP_E_EXCEPTION
0x80020009
 Terjadi kesalahan tidak terduga.

Keterangan

Komputer virtual 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