Интерфейс IVMTask
[Виртуальный компьютер Windows больше недоступен для использования с Windows 8. Вместо этого используйте поставщик WMI Hyper-V (V2).]
Используйте интерфейс IVMTask для мониторинга асинхронных задач для различных методов COM и управления ими.
Элементы
Интерфейс IVMTask наследуется от интерфейса IDispatch . IVMTask также имеет следующие типы элементов:
Методы
Интерфейс IVMTask содержит следующие методы.
| Метод | Описание |
|---|---|
| Отменить | Отменяет задачу. |
| WaitForCompletion | Ожидает завершения задачи или истечения указанного интервала времени ожидания. |
Свойства
Интерфейс IVMTask имеет следующие свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
|
Описание |
Только для чтения |
Описание задачи. |
|
Ошибка |
Только для чтения |
Ошибка, записанная для этой задачи. |
|
Описание ошибки |
Только для чтения |
Локализованное описание ошибки, записанное для этой задачи. |
|
ID |
Только для чтения |
Уникальный идентификатор для этой задачи. |
|
IsCancelable |
Только для чтения |
Указывает, можно ли отменить задачу. |
|
IsComplete |
Только для чтения |
Указывает, завершена ли задача. |
|
PercentCompleted |
Только для чтения |
Процент завершения задачи. |
|
Результат |
Только для чтения |
Результат задачи. |
Комментарии
Объект IVMTask возвращается методами, для завершения которых может потребоваться значительное время. Это позволяет приложению отслеживать ход выполнения требуемой операции, не блокируя дальнейшее выполнение во время ожидания завершения операции.
Следующие методы возвращают объект IVMTask , который можно использовать для отслеживания хода выполнения:
- 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
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 7 [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Окончание поддержки клиентов |
Windows 7 |
| Продукт |
Windows Virtual PC |
| Заголовок |
|
| IID |
IID_IVMTask определяется как ab72b222-6e9c-48ae-aa54-85e3e635767c |