IVMVirtualMachine :: SetConfigurationValue, méthode

[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]

Définit la valeur du paramètre de configuration spécifié pour cette machine virtuelle.

Syntaxe

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

Paramètres

configurationKey [ dans]

Clé utilisée pour identifier la valeur de configuration telle qu’elle est stockée dans le * fichier « . vmc ».

Important

Les modifications doivent être apportées à " * . VMC" uniquement à l’aide de la méthode SetConfigurationValue . La modification * de « . VMC » à l’aide d’une autre méthode n’est pas prise en charge.

configurationValue [ dans]

Valeur de configuration. Cette valeur peut être l’un des types de variantes suivants : VT _ Array | VT _ UI1 (RAW bytes), VT _ BSTR (String), VT _ UI4 (Integer) ou VT _ bool (Boolean).

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour Description
S _ OK
0
L'opération a réussi.
E _ INVALIDARG
0x80000003
Le paramètre configurationKey est null ou vide, ou le paramètre configurationValue n’est pas un type Variant valide.
Ordinateur virtuel _ _Machine virtuelle _
0xA0040207
inconnue
La configuration est inconnue.
DISP _ E _ exception
0x80020009
Une erreur inattendue s’est produite.

Remarques

Les valeurs suivantes sont prises en charge pour le paramètre configurationKey .

valeur configurationKey Description Type de données Valeur par défaut
« matériel/BIOS/ _ synchronisation de l’heure _ au _ démarrage »
« true » si l’horloge CMOS de la machine virtuelle doit être synchronisée avec l’horloge de l’hôte au démarrage ; « false » dans le cas contraire.
expression
"true"
« intégration/synchronisation de l’heure de l’hôte/de Microsoft/ _ _ activée »
« true » si la synchronisation de l’heure de l’hôte est activée dans les composants d’intégration ; « false » dans le cas contraire.
expression
"true"
« options d’interface utilisateur _ /publication de l' _ application automatique _ »
« true » si la publication automatique des applications est activée dans les composants d’intégration ; « false » dans le cas contraire. Cela est également appelé applications virtuelles.
expression
"true"
« _ options d’interface utilisateur/secondes _ à _ Enregistrer »
Nombre de secondes d’attente avant l’enregistrement de la machine virtuelle après la fermeture de toutes les applications. Toutefois, les valeurs inférieures à 20 et supérieures à 4 294 968 ont des significations particulières. Pour plus d’informations, consultez la liste suivante
entre
N’enregistrez jamais la machine virtuelle.
1 20
Patientez 20 secondes avant d’enregistrer la machine virtuelle.
21 4 294 967
Patientez le nombre de secondes spécifié avant d’enregistrer la machine virtuelle.
4 294 968 4 294 967 295
Attendez 4 294 968 secondes avant d’enregistrer la machine virtuelle.
entière
300

Cette méthode fournit un accès de bas niveau à toute valeur de configuration. Il peut être utilisé pour définir des valeurs de configuration pour les clés définies par le client. Soyez prudent si vous utilisez cette méthode pour définir les valeurs de configuration du système, car aucune vérification des erreurs n’est effectuée sur la valeur de configuration. En outre, certaines valeurs de configuration ne peuvent pas être modifiées pendant l’exécution de la machine virtuelle.

Les clés de configuration se trouvent dans le fichier « * . vmc » de l’ordinateur virtuel au format XML. Les clés sont stockées de manière hiérarchique comme les clés de Registre dans Windows. Pour spécifier une sous-clé spécifique, un « chemin d’accès de clé » est construit, qui spécifie les différentes clés dans un format délimité par des barres obliques.

Par exemple, pour définir la valeur de la clé « RAM _ Size » située dans l’arborescence de clé suivante :

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

La chaîne de chemin d’accès configurationKey est spécifiée comme suit :

"hardware/memory/ram_size"

Si l’une des clés de l’arborescence souhaitée a une valeur d’attribut « ID », l’attribut et sa valeur sont incorporés dans la chaîne de chemin d’accès configurationKey immédiatement après la clé de configuration associée en utilisant le format entre crochets suivant : « [ @id = »*_ valeur d’ID*« ] ».

Par exemple, pour définir la valeur de la clé « Golf » située dans l’arborescence de clé suivante :

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

La chaîne de chemin d’accès configurationKey est spécifiée comme suit :

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
applications de [ bureau Windows 7 uniquement]
Serveur minimal pris en charge
Aucun pris en charge
Fin de la prise en charge des clients
Windows 7
Produit
Windows Virtual PC
En-tête
VPCCOMInterfaces. h
IID
IID _ IVMVirtualMachine est défini en tant que f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine

IVMVirtualPC::SetConfigurationValue