Interface IVMTask

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

Utilisez l’interface IVMTask pour surveiller et contrôler les tâches asynchrones pour différentes méthodes COM.

Membres

L’interface IVMTask hérite de l’interface IDispatch. IVMTask a également les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

L’interface IVMTask a ces méthodes.

Méthode	Description
Annuler	Annule la tâche.
WaitForCompletion	Attend que la tâche se termine ou que l’intervalle de délai d’attente spécifié s’écoule.

Propriétés

L’interface IVMTask a ces propriétés.

Propriété	Type d’accès	Description
Description	Lecture seule	Une description de la tâche.
Error	Lecture seule	Erreur enregistrée pour cette tâche.
ErrorDescription	Lecture seule	Description de l’erreur localisée enregistrée pour cette tâche.
id	Lecture seule	Identificateur unique pour cette tâche.
IsCancelable	Lecture seule	Indique si la tâche peut être annulée.
IsComplete	Lecture seule	Indique si la tâche est terminée.
PercentCompleted	Lecture seule	Pourcentage d’achèvement de la tâche.
Résultats	Lecture seule	Résultat de la tâche.

Notes

Un objet IVMTask est retourné par des méthodes qui peuvent potentiellement nécessiter beaucoup de temps. Cela permet à l’application de surveiller la progression de l’opération souhaitée sans la forcer à bloquer la poursuite de l’exécution en attendant la fin de l’opération.

Les méthodes suivantes retournent un objet IVMTask qui peut être utilisé pour suivre la progression :

• IVMGuestOS::Logoff
• IVMGuestOS::Restart
• IVMGuestOS::Shutdown
• IVMHardDisk::Compact
• IVMHardDisk::Convert
• IVMHardDisk::Merge
• IVMHardDisk::MergeTo
• IVMVirtualMachine::MergeUndoDisks
• IVMVirtualMachine::Reset
• IVMVirtualMachine::Save
• IVMVirtualMachine::Startup
• IVMVirtualMachine::Startup2
• IVMVirtualMachine::TurnOff
• IVMVirtualPC::CreateDifferencingVirtualHardDisk
• IVMVirtualPC::CreateDynamicVirtualHardDisk
• IVMVirtualPC::CreateFixedVirtualHardDisk

Configuration requise

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_IVMTask est défini comme ab72b222-6e9c-48ae-aa54-85e3e635767c