IVMVirtualMachine::SetConfigurationValue, méthode

[Windows Virtual PC n’est plus disponible depuis Windows 8. Utilisez plutôt 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 [in]

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 [in]

Valeur de configuration. Cette valeur peut être l’un des types VARIANT suivants : VT_ARRAY|VT_UI1 (octets bruts), VT_BSTR (chaîne), VT_UI4 (entier) ou VT_BOOL (booléen).

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 de variante valide.
VM_E_VM_UNKNOWN 0xA0040207	La configuration est inconnue.
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.

Notes

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

Valeur configurationKey	Description	Type de données	Valeur par défaut
« hardware/bios/time_sync_at_boot »	« true » si l’horloge CMOS de la machine virtuelle doit être synchronisée avec l’horloge hôte au démarrage ; « false » sinon.	"boolean"	"true"
« integration/microsoft/host_time_sync/enabled »	« true » si la synchronisation de l’heure de l’hôte est activée dans les composants d’intégration ; « false » sinon.	"boolean"	"true"
« ui_options/auto_app_publish »	« true » si la publication automatique des applications est activée dans les composants d’intégration ; « false » sinon. Il s’agit également d’applications virtuelles.	"boolean"	"true"
« ui_options/seconds_to_save »	Nombre de secondes d’attente avant d’enregistrer la machine virtuelle après la fermeture de toutes les applications. Toutefois, les valeurs inférieures à 20 et supérieures à 4 294 968 ont une signification particulière. Pour plus d’informations, consultez la liste suivante 0 N’enregistrez jamais la machine virtuelle. 1 20 Attendez 20 secondes avant d’enregistrer la machine virtuelle. 21 4,294,967 Attendez 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.	« integer »	300

Cette méthode fournit un accès de bas niveau à n’importe quelle 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 des valeurs de configuration 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 la machine virtuelle au format XML. Les clés sont stockées de manière hiérarchique similaire aux clés de Registre dans Windows. Pour spécifier une sous-clé spécifique, un « chemin de clé » est construit qui spécifie les différentes clés dans un format délimité par une barre oblique.

Par exemple, pour définir la valeur de la clé « ram_size » située dans l’arborescence de clés 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 sa clé de configuration associée au format entre crochets suivant : « [@id="id_value"] ».

Par exemple, pour définir la valeur de la clé « golf » située dans l’arborescence de clés 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"

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau 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 comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine

IVMVirtualPC::SetConfigurationValue