Metodo IVMVirtualPC::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.

Sintassi

HRESULT SetConfigurationValue(
  [in] BSTR    preferenceKey,
  [in] VARIANT preferenceValue
);

Parametri

preferenceKey [in]: Chiave utilizzata per identificare le preferenze, come archiviato nel file di configurazione per utente (Options.xml in "%LocalAppData%\Microsoft\Windows Virtual PC").

Importante

Le modifiche devono essere apportate a Options.xml solo usando il metodo SetConfigurationValue . La modifica di Options.xml tramite qualsiasi altro metodo non è supportata.
preferenceValue [in]: Valore di preferenza. Questo valore può essere 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_POINTER 0x80004003	Il parametro preferenceKey o preferenceValue è NULL.
E_INVALIDARG 0x80000003	Il parametro preferenceKey non è valido o è una stringa vuota.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.
E_ACCESSDENIED 0x80070005	L'utente corrente ha accesso insufficiente al file di configurazione.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Il processore non supporta le estensioni haV (Hardware Accelerated Virtualization).

Commenti

I valori seguenti sono supportati per il parametro preferenceKey .

valore di preferenceKey	Descrizione	Tipo di dati	Valore predefinito
"idle_timeout"	Numero di secondi che vpc.exe devono attendere prima di uscire se non sono presenti macchine virtuali o applicazioni attive usando le interfacce PC virtuali Windows.	"integer"	"30"

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 di una macchina virtuale.

Le chiavi di configurazione si trovano nel file "Options.xml" 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 "idle_timeout" situata nell'albero delle chiavi seguente:

<preferences>
  <idle_timeout type="integer">60</idle_timeout>

La stringa di percorso preferenzaKey verrà specificata come segue:

"idle_timeout"

Se una delle chiavi nell'albero desiderato ha un valore di attributo "id", l'attributo e il relativo valore vengono incorporati nella stringa di percorso preferenza 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 preferenzaKey verrà specificata come segue:

"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_IVMVirtualPC è definito come 236ba0d9-a24a-4292-a132-27c1421dfd01

Vedi anche

IVMVirtualPC
IVMVirtualMachine::SetConfigurationValue

Condividi tramite