Metodo IVMVirtualMachine::RemoveConfigurationValue
[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 configurazione specificata per questa macchina virtuale.
Sintassi
HRESULT RemoveConfigurationValue(
[in] BSTR configurationKey
);
Parametri
-
configurationKey [in]
-
Chiave usata per identificare il valore di configurazione archiviato nel file "*.vmc".
Valore restituito
Questo metodo può restituire uno di questi valori.
Codice/valore restituito | Descrizione |
---|---|
|
L'operazione è stata completata. |
|
Il parametro è NULL o vuoto. |
|
La configurazione è sconosciuta. |
|
La preferenza non è stata trovata. |
|
Si è verificato un errore imprevisto. |
Commenti
Questo metodo fornisce l'accesso di basso livello a qualsiasi valore di configurazione. Può essere usato per rimuovere i valori di configurazione per le chiavi definite dal cliente. Prestare attenzione se si usa questo metodo per rimuovere i valori di configurazione di sistema, poiché alcuni valori non possono essere modificati durante l'esecuzione della macchina virtuale.
Le chiavi di configurazione si trovano nel file "*.vmc" della macchina virtuale in formato XML. Le chiavi vengono archiviate 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 "ram_size" che si trova nell'albero delle chiavi seguente:
<hardware>
<memory>
<ram_size type="integer">128</ram_size>
La stringa di percorso configurationKey viene specificata nel modo seguente:
"hardware/memory/ram_size"
Se una delle chiavi nell'albero desiderato ha un valore di attributo "id", l'attributo e il relativo valore sono incorporati nella stringa di percorso configurationKey immediatamente dopo la chiave di configurazione associata usando il formato tra parentesi quadre seguente: "[@id="id_value"]".
Ad esempio, per rimuovere il valore della chiave "assoluta" che si trova nell'albero delle chiavi seguente:
<hardware>
<pci_bus>
<ide_adapter>
<ide_controller id="1">
<location id="0">
<pathname>
<absolute type="string">D</absolute>
La stringa di percorso configurationKey viene specificata nel modo seguente:
"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"
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 |
|
IID |
IID_IVMVirtualMachine è definito come f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |