Compartir a través de

Método IVMVirtualMachine::StartCommunicationChannel

  • Artículo

[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2).]

Configura un canal de comunicación entre el host y el sistema operativo invitado.

Sintaxis

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

Parámetros

inHostEndpointType [in]

Este parámetro debe ser vmEndpoint_NamedPipe (0).

inHostEndPointName [in]

Nombre de canalización único. Esta cadena debe tener el siguiente formato: "\\.\pipe\pipename". La parte pipename del nombre puede incluir cualquier carácter que no sea una barra diagonal inversa, incluidos números y caracteres especiales. Toda la cadena de nombre de canalización puede tener hasta 256 caracteres. Los nombres de canalización no distinguen mayúsculas de minúsculas.

inGuestEndpointType [in]

Este parámetro debe ser vmEndpoint_TCPIP (1).

inGuestEndpointName [in]

Número de puerto en el que escucha el servidor TCP del invitado.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto Descripción
S_OK
0
 La operación se realizó correctamente.
E_INVALIDARG
0x80000003
 El parámetro inHostEndpointType no es vmEndpoint_NamedPipe (0) o el parámetro inGuestEndpointType no se vmEndpoint_TCPIP (1).
E_POINTER
0x80004003
 El parámetro inHostEndPointName o inGuestEndpointName es NULL o no es un valor válido.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
0x80070006
 Un identificador no es válido.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 No hay suficiente memoria disponible para completar esta solicitud.
HRESULT_FROM_WIN32(ERROR_NOT_READY)
0x80070015
 El sistema subyacente que usa para proporcionar servicios de red se está inicializando actualmente.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 El nombre de la canalización ya está en uso.
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY)
0x800700e7
 Uno o más canales están en funcionamiento y pueden estar disponibles en breve.
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED)
0x80070161
 Los números máximos de canales de comunicación disponibles están en uso. No se puede iniciar otro canal en este momento.
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH)
0x8007051a
 Hay una discrepancia entre la versión del host y los subsistemas invitados. Consulte el registro de eventos de Windows para obtener más detalles.
VM_E_VM_NOT_RUNNING
0xA0040206
 La máquina virtual no se está ejecutando.

Observaciones

La implementación actual solo admite la interfaz de canalización con nombre en el host y la interfaz TCP/IP en el sistema operativo invitado.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Fin de compatibilidad de cliente
 Windows 7
Producto
 Windows Virtual PC
Encabezado
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine se define como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Consulte también

IVMVirtualMachine

VMEndpointType