Metode IVMVirtualMachine::SetActivationValue

  • Artikel

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

Mengatur nilai pengaturan aktivasi yang ditentukan untuk komputer virtual ini.

Sintaks

HRESULT SetActivationValue(
  [in] BSTR    activationKey,
  [in] VARIANT activationValue
);

Parameter

activationKey [in]

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

activationValue [in]

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

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0
 Operasi berhasil.
E_INVALIDARG
0x80000003
 Parameter activationKey adalah NULL atau kosong, atau parameter activationValue bukan jenis varian yang valid.
VM_E_VM_UNKNOWN
0xA0040207
 Konfigurasi tidak diketahui.
VM_E_PREF_NOT_FOUND
0xA0040300
 Konfigurasi tidak memiliki aktivasi yang valid.
DISP_E_EXCEPTION
0x80020009
 Terjadi kesalahan tidak terduga.

Keterangan

Metode ini menyediakan akses tingkat rendah ke nilai aktivasi apa pun. Ini dapat digunakan untuk mengatur nilai aktivasi untuk kunci yang ditentukan pelanggan. Berhati-hatilah jika Anda menggunakan metode ini untuk mengatur nilai aktivasi sistem, karena tidak ada pemeriksaan kesalahan yang dilakukan pada nilai aktivasi. Selain itu, beberapa nilai aktivasi tidak dapat diubah saat komputer virtual sedang berjalan. Ketika komputer virtual dimulai, salinan terbuat dari nilai konfigurasinya, yang menjadi serangkaian nilai aktivasinya. Nilai aktivasi dipertahankan hingga komputer virtual dimatikan atau dimulai ulang. Perhatikan bahwa WINDOWS Virtual PC hanya dapat menggunakan konfigurasi untuk menyimpan nilai untuk kunci tertentu, yaitu, nilai aktivasi mungkin tidak pernah digunakan.

Catatan

Sesi komputer virtual harus berjalan sebelum nilai aktivasi apa pun dapat diubah.

Kunci aktivasi disimpan secara internal 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 "default_action" yang terletak di pohon kunci berikut:

<settings>
    <undo_drives>
        <default_action type="integer">1</default_action>

String jalur activationKey akan ditentukan sebagai berikut:

"settings/undo_drives/default_action"

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