Metodo IVMVirtualMachine::GetActivationValue

Articolo
06/13/2023

[Windows Virtual PC non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Recupera il valore dell'impostazione di attivazione specificata per questa macchina virtuale.

Sintassi

HRESULT GetActivationValue(
  [in]          BSTR    activationKey,
  [out, retval] VARIANT *activationValue
);

Parametri

activationKey [in]: Chiave usata per identificare il valore di attivazione come archiviato nel file "*.vmc".
activationValue [out, retval]: Valore di attivazione. Questo valore può essere uno dei tipi VARIANT seguenti:VT_ARRAY VT_UI1 (byte non elaborati),VT_BSTR | (stringa), VT_I4 (integer) o VT_BOOL (booleano).

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	L'operazione è stata completata.
E_INVALIDARG 0x80000003	Il parametro activationKey è NULL o vuoto.
E_POINTER 0x80004003	Il parametro activationValue è NULL.
VM_E_VM_UNKNOWN 0xA0040207	La configurazione è sconosciuta.
VM_E_PREF_NOT_FOUND 0xA0040300	La preferenza non è stata trovata oppure questa configurazione non ha attivazione valida.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

Questo metodo fornisce l'accesso a basso livello a qualsiasi valore di attivazione. Può essere usato per impostare i valori di attivazione per le chiavi definite dal cliente. Quando viene avviata una macchina virtuale, viene creata una copia dei relativi valori di configurazione, che diventa il set di valori di attivazione. I valori di attivazione vengono mantenuti finché la macchina virtuale non viene arrestata o riavviata. Si noti che Il PC virtuale Windows può usare solo la configurazione per archiviare i valori per determinate chiavi, ovvero il valore di attivazione potrebbe non essere mai usato.

Le chiavi di attivazione vengono archiviate internamente in modo gerarchico simile alle chiavi del Registro di sistema in Windows. Per specificare una sottochiave specifica, viene costruito un "percorso chiave" che specifica le varie chiavi in un formato delimitato da barre.

Ad esempio, per leggere il valore della chiave "default_action" situata nell'albero delle chiavi seguente:

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

La stringa di percorso activationKey verrà specificata come segue:

"settings/undo_drives/default_action"

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Fine del supporto client	Windows 7
Prodotto	Windows Virtual PC
Intestazione	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine è definito come f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Vedi anche

IVMVirtualMachine

Share via