Interface IVMTask
[O Computador Virtual do Windows não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]
Use a interface IVMTask para monitorar e controlar tarefas assíncronas para vários métodos COM.
Membros
A interface IVMTask herda da interface IDispatch . IVMTask também tem esses tipos de membros:
Métodos
A interface IVMTask tem esses métodos.
Método | Descrição |
---|---|
Cancelar | Cancela a tarefa. |
WaitForCompletion | Aguarda a conclusão da tarefa ou o intervalo de tempo limite especificado decorrido. |
Propriedades
A interface IVMTask tem essas propriedades.
Propriedade | Tipo de acesso | Descrição |
---|---|---|
Descrição |
Somente leitura |
Uma descrição da tarefa. |
Erro do |
Somente leitura |
O erro registrado para essa tarefa. |
Errordescription |
Somente leitura |
A descrição do erro localizada registrada para esta tarefa. |
ID |
Somente leitura |
Um identificador exclusivo para essa tarefa. |
IsCancelable |
Somente leitura |
Indica se a tarefa pode ser cancelada. |
Iscomplete |
Somente leitura |
Indica se a tarefa foi concluída. |
PercentCompleted |
Somente leitura |
O percentual de conclusão da tarefa. |
Resultado |
Somente leitura |
O resultado da tarefa. |
Comentários
Um objeto IVMTask é retornado por métodos que podem exigir uma quantidade significativa de tempo para ser concluído. Isso permite que o aplicativo monitore o progresso da operação desejada sem forçá-la a bloquear a execução adicional enquanto aguarda a conclusão da operação.
Os seguintes métodos retornam um objeto IVMTask que pode ser usado para acompanhar o progresso:
- 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
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte |
Windows 7 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte |
Nenhum compatível |
Fim do suporte ao cliente |
Windows 7 |
Produto |
Windows Virtual PC |
Cabeçalho |
|
IID |
IID_IVMTask é definido como ab72b222-6e9c-48ae-aa54-85e3e635767c |