IVMVirtualMachine::StartCommunicationChannel-Methode

[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung 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 folgendes Format aufweisen: " \ \ . \ pipe \ pipename". Der Pipename-Teil des Namens kann ein beliebiges Zeichen außer einem 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 inHostEndpointType-Parameter ist nicht vmEndpoint _ NamedPipe (0) oder der inGuestEndpointType-Parameter ist nicht vmEndpoint _ TCPIP (1).
E _ POINTER
0x80004003
Der inHostEndPointName- oder inGuestEndpointName-Parameter 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 abzuschließen.
HRESULT _ FROM _ WIN32(ERROR _ NOT _ READY)
0x80070015
Das zugrunde liegende System, das zur Bereitstellung 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 wird nicht mehr ausgeführt 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 Host- und gastsubsystems. Weitere Informationen finden Sie im Windows-Ereignisprotokoll.
VM _ E _ VM WIRD NICHT _ _ AUSGEFÜHRT,
0xA0040206
Der virtuelle Computer wird nicht ausgeführt.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
nur Windows 7 [ 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 als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert.

Siehe auch

IVMVirtualMachine

VMEndpointType