Share via

IVMVirtualMachine：：StartCommunicationChannel 方法

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

設定主機和客體作業系統之間的通道。

語法

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

參數

inHostEndpointType [in]

此參數必須 vmEndpoint_NamedPipe (0) 。

inHostEndPointName [in]

唯一管道名稱。 此字串的格式必須如下：「\\.\pipe\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
 VM 未執行。

備註

目前的實作僅支援主機上的具名管道介面，以及客體作業系統上的 TCP/IP 介面。

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
VPCOMInterfaces.h
IID
 IID_IVMVirtualMachine定義為 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另請參閱

IVMVirtualMachine

VMEndpointType