Metode IVMVirtualMachine::SetConfigurationValue

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

Mengatur nilai pengaturan konfigurasi yang ditentukan untuk komputer virtual (VM) ini.

Sintaks

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

Parameter

configurationKey [in]

Kunci yang digunakan untuk mengidentifikasi nilai konfigurasi seperti yang disimpan dalam file "*.vmc".

Penting

Perubahan harus dilakukan pada "*.vmc" hanya menggunakan metode SetConfigurationValue . Mengubah "*.vmc" menggunakan metode lain tidak didukung.

configurationValue [in]

Nilai konfigurasi. Cay nilai ini menjadi salah satu jenis VARIAN berikut: VT_ARRAY|VT_UI1 (byte mentah), VT_BSTR (string), VT_UI4 (bilangan bulat), atau VT_BOOL (Boolean).

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai	Deskripsi
S_OK 0	Operasi berhasil.
E_INVALIDARG 0x80000003	Parameter configurationKey adalah NULL atau kosong atau parameter configurationValue bukan jenis varian yang valid.
VM_E_VM_UNKNOWN 0xA0040207	Konfigurasi tidak diketahui.
DISP_E_EXCEPTION 0x80020009	Terjadi kesalahan tidak terduga.

Keterangan

Nilai berikut didukung untuk parameter configurationKey .

nilai configurationKey	Deskripsi	Jenis Data	Nilai default
"perangkat keras/bios/time_sync_at_boot"	"true" jika jam VM CMOS akan disinkronkan dengan jam host saat boot; "false" jika tidak.	"boolean"	"true"
"integration/microsoft/host_time_sync/enabled""	"true" jika sinkronisasi waktu host diaktifkan di komponen integrasi; "false" jika tidak.	"boolean"	"true"
"ui_options/auto_app_publish"	"true" jika penerbitan aplikasi otomatis diaktifkan dalam komponen integrasi; "false" jika tidak. Ini juga disebut aplikasi virtual.	"boolean"	"true"
"ui_options/seconds_to_save"	Jumlah detik untuk menunggu sebelum menyimpan VM setelah semua aplikasi ditutup. Namun, nilai di bawah 20 dan lebih dari 4.294.968 memiliki arti khusus. Untuk detailnya, lihat daftar berikut ini 0 Jangan pernah menyimpan VM. 1 20 Tunggu 20 detik sebelum menyimpan VM. 21 4,294,967 Tunggu jumlah detik yang ditentukan sebelum menyimpan VM. 4,294,968 4,294,967,295 Tunggu 4.294.968 detik sebelum menyimpan VM.	"bilangan bulat"	300

Metode ini menyediakan akses tingkat rendah ke nilai konfigurasi apa pun. Ini dapat digunakan untuk mengatur nilai konfigurasi untuk kunci yang ditentukan pelanggan. Berhati-hatilah jika Anda menggunakan metode ini untuk mengatur nilai konfigurasi sistem, karena tidak ada pemeriksaan kesalahan yang dilakukan pada nilai konfigurasi. Selain itu, beberapa nilai konfigurasi tidak dapat diubah saat komputer virtual sedang berjalan.

Kunci konfigurasi terletak di file "*.vmc" komputer virtual dalam format XML. Kunci disimpan dengan cara hierarkis yang mirip dengan kunci registri di Windows. Untuk menentukan subkunci tertentu, "jalur kunci" dibangun yang menentukan berbagai kunci dalam format yang dibatasi tanda garis miring.

Misalnya, untuk mengatur nilai kunci "ram_size" yang terletak di pohon kunci berikut:

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

String jalur configurationKey akan ditentukan sebagai berikut:

"hardware/memory/ram_size"

Jika salah satu kunci di pohon yang diinginkan memiliki nilai atribut "id", atribut dan nilainya disematkan dalam string jalur configurationKey segera setelah kunci konfigurasi terkait menggunakan format kurung berikut: "[@id="id_value"]".

Misalnya, untuk mengatur nilai kunci "golf" yang terletak di pohon kunci berikut:

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

String jalur configurationKey akan ditentukan sebagai berikut:

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

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

IVMVirtualPC::SetConfigurationValue