IVMVirtualMachine::GetActivationValue, méthode

Article
06/13/2023

[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Récupère la valeur du paramètre d’activation spécifié pour cette machine virtuelle.

Syntaxe

HRESULT GetActivationValue(
  [in]          BSTR    activationKey,
  [out, retval] 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 [out, retval]: Valeur d’activation. Cette valeur peut être l’un des types VARIANT suivants : VT_ARRAY | 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 activationKey est NULL ou vide.
E_POINTER 0x80004003	Le paramètre activationValue est NULL.
VM_E_VM_UNKNOWN 0xA0040207	La configuration est inconnue.
VM_E_PREF_NOT_FOUND 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.

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. 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.

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 lire 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	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine est défini comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine

Partager via