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
S _ OK
0
L'opération a réussi.
E _ INVALIDARG
0x80000003
Le paramètre a la valeur null ou est vide.
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 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
VPCCOMInterfaces. h
IID
IID _ IVMVirtualMachine est défini en tant que f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine