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 |
|---|---|
|
L'opération a réussi. |
|
Le paramètre clé est null ou vide. |
|
Le paramètre activationValue a la valeur null. |
|
La configuration est inconnue. |
|
La préférence est introuvable, ou cette configuration n’a pas d’activation valide. |
|
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 |
|
| IID |
IID _ IVMVirtualMachine est défini en tant que f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |