IVMVirtualMachine :: RemoveActivationValue, 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).]
Supprime la valeur du paramètre d’activation spécifié pour cet ordinateur virtuel.
Syntaxe
HRESULT RemoveActivationValue(
[in] BSTR activationKey
);
Paramètres
-
clé [ dans]
-
Clé utilisée pour identifier la valeur d’activation telle qu’elle est stockée dans le * fichier « . vmc ».
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 a la valeur null ou est vide. |
|
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 supprimer des valeurs d’activation pour les clés définies par le client. Soyez prudent si vous utilisez cette méthode pour supprimer les valeurs d’activation du système, car certaines valeurs ne peuvent pas être modifiées pendant l’exécution de la machine virtuelle. 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.
Notes
La session de l’ordinateur virtuel doit être en cours d’exécution pour que toutes les valeurs d’activation puissent être modifiées.
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 supprimer 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 |