IVMVirtualMachine::Startup2, 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).]

Démarre la machine virtuelle à partir de l’état non initialisé ou enregistré, avec des options avancées.

Cette méthode fournit un mécanisme pour démarrer une machine virtuelle avec un disque de différenciation même si l’horodatage du disque parent a été modifié.

Syntaxe

HRESULT Startup2(
  [in]          VMStartupOption startupOption,
  [out, retval] IVMTask         **startupTask
);

Paramètres

startupOption [in]: Option de démarrage avancée. Les valeurs possibles proviennent de l’énumération VMStartupOption .
startupTask [out, retval]: Objet IVMTask utilisé pour suivre la progression de l’achèvement de la séquence de début.

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 startupOption n’est pas valide.
E_POINTER 0x80004003	Le paramètre startupTask est NULL.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	L’appelant doit disposer des autorisations d’accès d’exécution pour démarrer cette machine virtuelle.
VM_E_TIMED_OUT 0xA0040202	L’opération ne s’est pas terminée en temps opportun.
VM_E_OUT_OF_RESOURCE 0xA0040203	Il n’y a pas assez de ressources hôtes.
VM_E_TOO_MANY_VMS 0xA0040204	Il y a trop de machines virtuelles actives.
VM_E_VM_RUNNING 0xA0040500	La machine virtuelle est déjà en cours d’exécution.
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.

Notes

Les valeurs suivantes peuvent être retournées via la propriété Error de l’objet IVMTask retourné.

Code d’erreur /Valeur	Description
`VM_E_UNSUPPORTED_HARDWARE` (0xA0040950)	Le matériel ne prend pas en charge la virtualisation.
`VM_E_HARDWARE_VIRTUALIZATION_DISABLED` (0xA0040951)	La virtualisation matérielle est désactivée.
`VM_E_VMVIRTUALPC_OLDER_VERSION` (0xA0040952)	Virtual PC 2007 et Windows Virtual PC sont installés.
`VM_E_OTHER_VIRTUALIZATION_SOFTWARE` (0xA0040953)	D’autres logiciels de virtualisation sont installés.
`VM_E_OUT_OF_RESOURCE` (0xa00400203)	Il n’y a pas assez de ressources hôtes.

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