Metode IVMVirtualMachine::RemoveConfigurationValue

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

Menghapus nilai pengaturan konfigurasi yang ditentukan untuk komputer virtual ini.

Sintaks

HRESULT RemoveConfigurationValue(
  [in] BSTR configurationKey
);

Parameter

configurationKey [in]

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

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai	Deskripsi
S_OK 0	Operasi berhasil.
E_INVALIDARG 0x80000003	Parameternya NULL atau kosong.
VM_E_VM_UNKNOWN 0xA0040207	Konfigurasi tidak diketahui.
VM_E_PREF_NOT_FOUND 0xA0040300	Preferensi tidak ditemukan.
DISP_E_EXCEPTION 0x80020009	Terjadi kesalahan tidak terduga.

Keterangan

Metode ini menyediakan akses tingkat rendah ke nilai konfigurasi apa pun. Ini dapat digunakan untuk menghapus nilai konfigurasi untuk kunci yang ditentukan pelanggan. Berhati-hatilah jika Anda menggunakan metode ini untuk menghapus nilai konfigurasi sistem, karena beberapa nilai 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 menghapus nilai kunci "ram_size" yang terletak di pohon kunci berikut:

<hardware>
    <memory>
        <ram_size type="integer">128</ram_size>

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 menghapus nilai kunci "absolut" yang terletak di pohon kunci berikut:

<hardware>
    <pci_bus>
        <ide_adapter>
            <ide_controller id="1">
                <location id="0">
                    <pathname>
                        <absolute type="string">D</absolute>

String jalur configurationKey akan ditentukan sebagai berikut:

"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"

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