IVMVirtualMachine :: GetActivationValue, 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).]

Récupère la valeur du paramètre d’activation spécifié pour cet ordinateur virtuel.

Syntaxe

HRESULT GetActivationValue(
  [in]          BSTR    activationKey,
  [out, retval] VARIANT *activationValue
);

Paramètres

clé [ dans]

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

activationValue [ out, retval]

Valeur d’activation. Cette valeur peut être l’un des types de variantes suivants : VT _ tableau VT | _ UI1 (octets bruts), VT _ BSTR (chaîne), VT _ I4 (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 clé est null ou vide.
E _ POINTEUR
0x80004003
Le paramètre activationValue a la valeur null.
Ordinateur virtuel _ _Machine virtuelle _
0xA0040207
inconnue
La configuration est inconnue.
Ordinateur virtuel _ E _ Préférences _ _ introuvables
0xA0040300
La préférence est introuvable, ou cette configuration n’a pas d’activation valide.
DISP _ E _ exception
0x80020009
Une erreur inattendue s’est produite.

Remarques

Cette méthode fournit un accès de bas niveau à toute valeur d’activation. Il peut être utilisé pour définir des valeurs d’activation pour les clés définies par le client. Lorsqu’un ordinateur virtuel est démarré, une copie de ses valeurs de configuration est créée, qui devient son ensemble de valeurs d’activation. Les valeurs d’activation sont conservées jusqu’à ce que la machine virtuelle soit arrêtée ou redémarrée. notez que Windows Virtual PC peut uniquement utiliser la configuration pour stocker des valeurs pour certaines clés, autrement dit, la valeur d’activation peut ne jamais être utilisée.

Les clés d’activation sont stockées en interne de manière hiérarchique, à l’instar des 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 lire la valeur de la clé « _ action par défaut » située dans l’arborescence de clé suivante :

<settings>
    <undo_drives>
        <default_action type="integer">1</default_action>

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

"settings/undo_drives/default_action"

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