Метод IVMVirtualPC::FindVirtualNetwork

  • Статья
  • Чтение занимает 2 мин

[Windows Виртуальный компьютер больше недоступен для использования с Windows 8. Вместо этого используйте поставщик WMI Hyper-V (V2).]

Извлекает объект виртуальной сети, соответствующий запрашиваемого имени.

Синтаксис

HRESULT FindVirtualNetwork(
  [in]          BSTR              virtualNetworkName,
  [out, retval] IVMVirtualNetwork **virtualNetwork
);

Параметры

virtualNetworkName [in]

Имя виртуальной сети для поиска.

virtualNetwork [out, retval]

Указатель на новый объект IVMVirtualNetwork , представляющий эту виртуальную сеть.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемый код или значение Описание
S_OK
0
 Операция выполнена успешно.
S_FALSE
1
 Не удалось найти указанную виртуальную сеть.
E_POINTER
0x80004003
 Параметр virtualNetwork имеет значение NULL или виртуальная сеть не найдена.
E_INVALIDARG
0x80000003
 Недопустимый параметр virtualNetworkName или является пустой строкой.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Не удалось найти файл виртуальной сети.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Процессор не поддерживает расширения аппаратной ускоренной виртуализации (HAV).

Remarks

Имена виртуальных сетей не учитывают регистр, например MyNetwork и mynetwork, ссылаются на ту же виртуальную сеть.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPC определен как 236ba0d9-a24a-4292-a132-27c1421dfd01

См. также раздел

IVMVirtualPC