Metode IVMVirtualPC::SetConfigurationValue

Artikel
09/21/2022
2 menit untuk membaca

[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.

Sintaks

HRESULT SetConfigurationValue(
  [in] BSTR    preferenceKey,
  [in] VARIANT preferenceValue
);

Parameter

preferenceKey [in]: Kunci yang digunakan untuk mengidentifikasi preferensi, seperti yang disimpan dalam file konfigurasi per pengguna (Options.xml di "%LocalAppData%\Microsoft\Windows Virtual PC").

Penting

Perubahan harus dilakukan pada Options.xml hanya menggunakan metode SetConfigurationValue . Mengubah Options.xml menggunakan metode lain tidak didukung.
preferenceValue [in]: Nilai preferensi. Nilai ini mungkin 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_POINTER 0x80004003	Parameter preferenceKey atau preferenceValue adalah NULL.
E_INVALIDARG 0x80000003	Parameter preferenceKey tidak valid atau merupakan string kosong.
DISP_E_EXCEPTION 0x80020009	Terjadi kesalahan tidak terduga.
E_ACCESSDENIED 0x80070005	Pengguna saat ini tidak memiliki akses yang cukup ke file konfigurasi.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Prosesor tidak mendukung ekstensi Hardware Accelerated Virtualization (HAV).

Keterangan

Nilai berikut didukung untuk parameter preferenceKey .

nilai preferenceKey	Deskripsi	Jenis Data	Nilai default
"idle_timeout"	Jumlah detik yang vpc.exe harus menunggu sebelum keluar jika tidak ada VM atau aplikasi aktif yang menggunakan Antarmuka PC Virtual Windows.	"bilangan bulat"	"30"

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 "Options.xml" 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 "idle_timeout" yang terletak di pohon kunci berikut:

<preferences>
  <idle_timeout type="integer">60</idle_timeout>

String jalur preferenceKey akan ditentukan sebagai berikut:

"idle_timeout"

Jika salah satu kunci di pohon yang diinginkan memiliki nilai atribut "id", atribut dan nilainya disematkan dalam string jalur preferenceKey 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>