IVMVirtualMachine:: StartCommunicationChannel 方法

[Windows Virtual PC 不再可用于 Windows 8。 请改用 HYPER-V WMI 提供程序 (V2) 。]

设置主机和来宾操作系统之间的信道。

语法

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

参数

inHostEndpointType [中]

此参数必须是 vmEndpoint _ NamedPipe (0) 。

inHostEndPointName [中]

唯一管道名称。 此字符串必须采用以下格式: " \ \ 。 \管道 \ pipename"。 名称的 pipename 部分可以包含除反斜杠之外的任何字符,包括数字和特殊字符。 整个管道名称字符串的长度最大可为256个字符。 管道名称不区分大小写。

inGuestEndpointType [中]

此参数必须 vmEndpoint _ TCPIP (1) 。

inGuestEndpointName [中]

来宾中的 TCP 服务器正在侦听的端口号。

返回值

此方法可以返回这些值之一。

返回代码/值 描述
S _正常
0
操作成功。
E _INVALIDARG
0x80000003
InHostEndpointType 参数不是 vmEndpoint _ NamedPipe (0) 或 inGuestEndpointType 参数不是 vmEndpoint _ TCPIP (1) 。
E _指针
0x80004003
InHostEndPointNameInGuestEndpointName 参数为 NULL 或不是有效的值。
上 _E _ EXCEPTION
0x80020009
发生意外错误。
HRESULT _FROM _ WIN32 (错误 _ _ 句柄无效)
0x80070006
句柄无效。
HRESULT _从 _ WIN32 (错误 _ OUTOFMEMORY)
0x8007000e
没有足够的可用内存来完成此请求。
HRESULT _从 _ WIN32 (错误 _ 未 _ 就绪)
0x80070015
它用来提供网络服务的基础系统当前正在初始化。
HRESULT _从 _ WIN32 (错误 _ 已 _ 存在)
0x800700b7
管道名称已在使用中。
HRESULT _从 _ WIN32 (错误 _ 管道 _ 忙)
0x800700e7
一个或多个通道正在关闭,可能很快就会变得可用。
HRESULT _从 _ WIN32 (错误 _ 达到的最大 _ 会话数 _)
0x80070161
可用的最大通信通道数。 此时无法启动另一个通道。
HRESULT _FROM _ WIN32 (错误 _ 修订 _)
0x8007051a
主机和来宾子系统的版本不匹配。 有关更多详细信息,请参阅 Windows 事件日志。
VM _E _ VM _ 未 _ 运行
0xA0040206
VM 未运行。

备注

当前实现仅支持来宾操作系统上的主机和 TCP/IP 接口上的命名管道接口。

要求

要求
最低受支持的客户端
[仅限 Windows 7 桌面应用]
最低受支持的服务器
无受支持的版本
客户端支持结束
Windows 7
产品
Windows Virtual PC
标头
VPCCOMInterfaces
IID
IID _ IVMVirtualMachine 定义为 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另请参阅

IVMVirtualMachine

VMEndpointType