IVMVirtualPC::GetConfigurationValue, méthode

Article
06/13/2023

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

Récupère la valeur du paramètre de configuration spécifié.

Syntaxe

HRESULT GetConfigurationValue(
  [in]          BSTR    preferenceKey,
  [out, retval] VARIANT *preferenceValue
);

Paramètres

preferenceKey [in]: Clé utilisée pour identifier la préférence, telle qu’elle est stockée dans le fichier de configuration.
preferenceValue [out, retval]: Valeur de préférence. Ce paramètre 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_POINTER 0x80004003	Le paramètre preferenceKey ou preferenceValue est NULL.
VM_E_PREF_NOT_FOUND 0xa0040300	La préférence est introuvable.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Le processeur ne prend pas en charge les extensions HAV (Hardware Accelerated Virtualization).
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 de préférence pour l’utilisateur actuel. Il peut être utilisé pour récupérer des valeurs de préférence pour les clés définies par le client.

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_IVMVirtualPC est défini comme 236ba0d9-a24a-4292-a132-27c1421dfd01

Voir aussi

IVMVirtualPC

Partager via