Método IVMVirtualMachine::StartCommunicationChannel
[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 |
---|---|
|
La operación se realizó correctamente. |
|
El parámetro inHostEndpointType no es vmEndpoint_NamedPipe (0) o el parámetro inGuestEndpointType no se vmEndpoint_TCPIP (1). |
|
El parámetro inHostEndPointName o inGuestEndpointName es NULL o no es un valor válido. |
|
Se produjo un error inesperado. |
|
Un identificador no es válido. |
|
No hay suficiente memoria disponible para completar esta solicitud. |
|
El sistema subyacente que usa para proporcionar servicios de red se está inicializando actualmente. |
|
El nombre de la canalización ya está en uso. |
|
Uno o más canales están en funcionamiento y pueden estar disponibles en breve. |
|
Los números máximos de canales de comunicación disponibles están en uso. No se puede iniciar otro canal en este momento. |
|
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. |
|
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 |
|
IID |
IID_IVMVirtualMachine se define como f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |