Метод IVMVirtualMachine::StartCommunicationChannel

  • Статья

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

Настраивает канал связи между узлом и гостевой операционной системой.

Синтаксис

HRESULT StartCommunicationChannel(
  [in] VMEndpointType inHostEndpointType,
  [in] BSTR           inHostEndPointName,
  [in] VMEndpointType inGuestEndpointType,
  [in] BSTR           inGuestEndpointName
);

Параметры

inHostEndpointType [in]

Этот параметр должен быть vmEndpoint_NamedPipe (0).

inHostEndPointName [in]

Уникальное имя канала. Эта строка должна иметь следующую форму: "\.\pipe\pipename". Часть имени канала может содержать любой символ, отличный от обратной косой черты, включая цифры и специальные символы. Вся строка имени канала может содержать до 256 символов. В именах каналов регистр не учитывается.

inGuestEndpointType [in]

Этот параметр должен быть vmEndpoint_TCPIP (1).

inGuestEndpointName [in]

Номер порта, на котором прослушивается TCP-сервер в гостевой системе.

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

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

Возвращаемый код или значение Описание
S_OK
0
 Операция выполнена успешно.
E_INVALIDARG
0x80000003
 Параметр inHostEndpointType не vmEndpoint_NamedPipe (0) или параметр inGuestEndpointType не vmEndpoint_TCPIP (1).
E_POINTER
0x80004003
 Параметр inHostEndPointName или inGuestEndpointName имеет значение NULL или не является допустимым.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
0x80070006
 Недопустимый дескриптор.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 Недостаточно памяти для выполнения этого запроса.
HRESULT_FROM_WIN32(ERROR_NOT_READY)
0x80070015
 Базовая система, использующаяся для предоставления сетевых служб, в настоящее время инициализируется.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Имя канала уже используется.
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY)
0x800700e7
 Один или несколько каналов не работают и могут стать доступными в ближайшее время.
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED)
0x80070161
 Используется максимальное количество доступных каналов связи. В настоящее время не удается запустить другой канал.
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH)
0x8007051a
 Существует несоответствие между версией главного и гостевого подсистем. Дополнительные сведения см. в журнале событий Windows.
VM_E_VM_NOT_RUNNING
0xA0040206
 Виртуальная машина не запущена.

Комментарии

Текущая реализация поддерживает только интерфейс именованного канала на узле и интерфейс TCP/IP в гостевой операционной системе.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine определяется как f7092aa1-33ed-4f78-a59f-c00adfc2edd7

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

IVMVirtualMachine

VMEndpointType