IVMVirtualPC::SetConfigurationValue, méthode

Article
06/13/2023

[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é.

Syntaxe

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

Paramètres

preferenceKey [in]: Clé utilisée pour identifier la préférence, telle qu’elle est stockée dans le fichier de configuration par utilisateur (Options.xml dans « %LocalAppData%\Microsoft\Windows Virtual PC »).

Important

Des modifications doivent être apportées à Options.xml uniquement à l’aide de la méthode SetConfigurationValue . La modification Options.xml à l’aide d’une autre méthode n’est pas prise en charge.
preferenceValue [in]: Valeur de préférence. 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_POINTER 0x80004003	Le paramètre preferenceKey ou preferenceValue est NULL.
E_INVALIDARG 0x80000003	Le paramètre preferenceKey n’est pas valide ou est une chaîne vide.
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.
E_ACCESSDENIED 0x80070005	L’utilisateur actuel n’a pas suffisamment accès au fichier de configuration.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Le processeur ne prend pas en charge les extensions HAV (Hardware Accelerated Virtualization).

Notes

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

Valeur preferenceKey	Description	Type de données	Valeur par défaut
« idle_timeout »	Nombre de secondes pendant lesquelles vpc.exe doit attendre avant de quitter si aucune machine virtuelle ou application n’utilise les interfaces pc virtuels Windows.	« integer »	"30"

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 d’une machine virtuelle.

Les clés de configuration se trouvent dans le fichier « Options.xml » 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é « idle_timeout » située dans l’arborescence de clés suivante :

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

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

"idle_timeout"

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 de la clé de préférence immédiatement après la clé de configuration associée à l’aide du 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 preferenceKey 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_IVMVirtualPC est défini comme 236ba0d9-a24a-4292-a132-27c1421dfd01

Voir aussi

IVMVirtualPC
IVMVirtualMachine::SetConfigurationValue

Share via