IVMVirtualMachine::SetActivationValue, méthode
[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]
Définit la valeur du paramètre d’activation spécifié pour cette machine virtuelle.
Syntaxe
HRESULT SetActivationValue(
[in] BSTR activationKey,
[in] VARIANT activationValue
);
Paramètres
-
activationKey [in]
-
Clé utilisée pour identifier la valeur d’activation telle qu’elle est stockée dans le fichier « *.vmc ».
-
activationValue [in]
-
Valeur d’activation. 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 |
---|---|
|
L'opération a réussi. |
|
Le paramètre activationKey est NULL ou vide, ou le paramètre activationValue n’est pas un type de variante valide. |
|
La configuration est inconnue. |
|
La configuration n’a pas d’activation valide. |
|
Une erreur inattendue s’est produite. |
Notes
Cette méthode fournit un accès de bas niveau à n’importe quelle valeur d’activation. Il peut être utilisé pour définir des valeurs d’activation pour les clés définies par le client. Soyez prudent si vous utilisez cette méthode pour définir des valeurs d’activation système, car aucune vérification d’erreur n’est effectuée sur la valeur d’activation. En outre, certaines valeurs d’activation ne peuvent pas être modifiées pendant l’exécution de la machine virtuelle. Lorsqu’une machine virtuelle est démarrée, une copie de ses valeurs de configuration est effectué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 utiliser la configuration uniquement pour stocker des valeurs pour certaines clés, c’est-à-dire que la valeur d’activation peut ne jamais être utilisée.
Notes
La session de machine virtuelle doit être en cours d’exécution avant que les valeurs d’activation puissent être modifiées.
Les clés d’activation sont stockées en interne 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é « default_action » située dans l’arborescence de clés suivante :
<settings>
<undo_drives>
<default_action type="integer">1</default_action>
La chaîne de chemin d’accès activationKey est spécifiée comme suit :
"settings/undo_drives/default_action"
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 |
|
IID |
IID_IVMVirtualMachine est défini comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour