Metode IVMVirtualMachine::GetConfigurationValue
[Windows Virtual PC tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan penyedia Hyper-V WMI (V2).]
Mengambil nilai pengaturan konfigurasi yang ditentukan untuk komputer virtual ini.
Sintaks
HRESULT GetConfigurationValue(
[in] BSTR configurationKey,
[out, retval] VARIANT *configurationValue
);
Parameter
-
configurationKey [in]
-
Kunci yang digunakan untuk mengidentifikasi nilai konfigurasi seperti yang disimpan dalam file "*.vmc".
-
configurationValue [out, retval]
-
Nilai konfigurasi. Nilai ini bisa menjadi salah satu jenis VARIAN berikut: VT_ARRAY|VT_UI1 (byte mentah), VT_BSTR (string), VT_I4 (bilangan bulat), atau VT_BOOL (Boolean).
Mengembalikan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Operasi berhasil. |
|
Parameter configurationKey adalah NULL atau kosong. |
|
Parameter configurationValue adalah NULL. |
|
Konfigurasi tidak diketahui. |
|
Preferensi tidak ditemukan. |
|
Terjadi kesalahan tidak terduga. |
Keterangan
Metode ini menyediakan akses tingkat rendah ke nilai konfigurasi apa pun. Ini dapat digunakan untuk membaca nilai konfigurasi untuk kunci yang ditentukan pelanggan.
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 membaca 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 membaca 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 |
|
IID |
IID_IVMVirtualMachine didefinisikan sebagai f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk