Metodo IVMVirtualMachine::SetConfigurationValue

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).]

Imposta il valore dell'impostazione di configurazione specificata per questa macchina virtuale (VM).

Sintassi

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

Parametri

configurationKey [in]: Chiave usata per identificare il valore di configurazione archiviato nel file "*.vmc".

Importante

Le modifiche devono essere apportate solo a "*.vmc" usando il metodo SetConfigurationValue . La modifica di "*.vmc" con qualsiasi altro metodo non è supportata.
configurationValue [in]: Valore di configurazione. Questo valore è uno dei tipi VARIANT seguenti: VT_ARRAY VT_UI1| (byte non elaborati),VT_BSTR (stringa), VT_UI4 (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 configurationKey è NULL o vuoto o il parametro configurationValue non è un tipo variant valido.
VM_E_VM_UNKNOWN 0xA0040207	La configurazione è sconosciuta.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

I valori seguenti sono supportati per il parametro configurationKey .

valore configurationKey	Descrizione	Tipo di dati	Valore predefinito
"hardware/bios/time_sync_at_boot"	"true" se l'orologioo virtuale vm deve essere sincronizzato con l'orologio host all'avvio; "false" in caso contrario.	"boolean"	"true"
"integration/microsoft/host_time_sync/enabled"	"true" se la sincronizzazione dell'ora host è abilitata nei componenti di integrazione; "false" in caso contrario.	"boolean"	"true"
"ui_options/auto_app_publish"	"true" se la pubblicazione automatica delle applicazioni è abilitata nei componenti di integrazione; "false" in caso contrario. Si tratta anche di applicazioni virtuali.	"boolean"	"true"
"ui_options/seconds_to_save"	Numero di secondi di attesa prima di salvare la macchina virtuale dopo la chiusura di tutte le applicazioni. Tuttavia, i valori inferiori a 20 e più di 4.294.968 hanno significati speciali. Per informazioni dettagliate, vedere l'elenco seguente 0 Non salvare mai la macchina virtuale. 1 20 Attendere 20 secondi prima di salvare la macchina virtuale. 21 4,294,967 Attendere il numero specificato di secondi prima di salvare la macchina virtuale. 4,294,968 4,294,967,295 Attendere 4.294.968 secondi prima di salvare la macchina virtuale.	"integer"	300

Questo metodo fornisce l'accesso a basso livello a qualsiasi valore di configurazione. Può essere usato per impostare i valori di configurazione per le chiavi definite dal cliente. Prestare attenzione se si usa questo metodo per impostare i valori di configurazione del sistema, perché non viene eseguito alcun controllo degli errori sul valore di configurazione. Non è inoltre possibile modificare alcuni valori di configurazione 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 barre.

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

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

La stringa di percorso configurationKey verrà 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 vengono incorporati nella stringa del percorso configurationKey immediatamente dopo la relativa chiave di configurazione associata usando il formato tra parentesi quadre seguente: "[@id="id_value"]".

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

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

La stringa di percorso configurationKey verrà specificata nel modo seguente:

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

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
IVMVirtualPC::SetConfigurationValue

Share via