IVMVirtualMachine::StartCommunicationChannel-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Richtet einen Kommunikationskanal zwischen Host- und Gastbetriebssystem ein.

Syntax

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

Parameter

inHostEndpointType [in]

Dieser Parameter muss vmEndpoint_NamedPipe (0) sein.

inHostEndPointName [in]

Der eindeutige Pipename. Diese Zeichenfolge muss die folgende Form aufweisen: "\\.\pipe\pipename". Der Pipename-Teil des Namens kann jedes andere Zeichen als einen umgekehrten Schrägstrich enthalten, einschließlich Zahlen und Sonderzeichen. Die gesamte Pipenamenzeichenfolge kann bis zu 256 Zeichen lang sein. Bei Pipenamen wird die Groß-/Kleinschreibung nicht beachtet.

inGuestEndpointType [in]

Dieser Parameter muss vmEndpoint_TCPIP (1) sein.

inGuestEndpointName [in]

Die Portnummer, an der der TCP-Server im Gast lauscht.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
 Der Vorgang wurde durchgeführt.
E_INVALIDARG
0x80000003
 Der parameter inHostEndpointType ist nicht vmEndpoint_NamedPipe (0) oder der parameter inGuestEndpointType ist nicht vmEndpoint_TCPIP (1).
E_POINTER
0x80004003
 Der Parameter inHostEndPointName oder inGuestEndpointName ist NULL oder kein gültiger Wert.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
0x80070006
 Ein Handle ist ungültig.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 Es ist nicht genügend Arbeitsspeicher verfügbar, um diese Anforderung auszuführen.
HRESULT_FROM_WIN32(ERROR_NOT_READY)
0x80070015
 Das zugrunde liegende System, das zum Bereitstellen von Netzwerkdiensten verwendet wird, wird derzeit initialisiert.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Der Pipename wird bereits verwendet.
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY)
0x800700e7
 Mindestens ein Kanal ist ausgefallen und kann in Kürze verfügbar sein.
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED)
0x80070161
 Die maximale Anzahl der verfügbaren Kommunikationskanäle wird verwendet. Ein anderer Kanal kann derzeit nicht gestartet werden.
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH)
0x8007051a
 Es besteht ein Konflikt zwischen der Version des Hosts und des Gastsubsystems. Weitere Informationen finden Sie im Windows-Ereignisprotokoll.
VM_E_VM_NOT_RUNNING
0xA0040206
 Der virtuelle Computer wird nicht ausgeführt.

Bemerkungen

Die aktuelle Implementierung unterstützt nur die Named Pipe-Schnittstelle auf dem Host und die TCP/IP-Schnittstelle auf dem Gastbetriebssystem.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Nicht unterstützt
Ende des Supports (Client)
 Windows 7
Produkt
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine ist definiert als f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Siehe auch

IVMVirtualMachine

VMEndpointType