Condividi tramite


Metodo IVMVirtualMachine::RemoveActivationValue

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

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

Sintassi

HRESULT RemoveActivationValue(
  [in] BSTR activationKey
);

Parametri

activationKey [in]

Chiave usata per identificare il valore di attivazione archiviato nel file "*.vmc".

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 è NULL o vuoto.
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 accesso di basso livello a qualsiasi valore di attivazione. Può essere usato per rimuovere i valori di attivazione per le chiavi definite dal cliente. Prestare attenzione se si usa questo metodo per rimuovere i valori di attivazione del sistema, poiché alcuni valori non possono essere modificati durante l'esecuzione della macchina virtuale. 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 fino a quando 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.

Nota

La sessione della macchina virtuale deve essere in esecuzione prima di poter modificare i valori di attivazione.

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

Ad esempio, per rimuovere il valore della chiave "default_action" che si trova nell'albero delle chiavi seguente:

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

La stringa del percorso activationKey viene specificata nel modo seguente:

"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