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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der inHostEndpointType-Parameter ist nicht vmEndpoint _ NamedPipe (0) oder der inGuestEndpointType-Parameter ist nicht vmEndpoint _ TCPIP (1). |
|
Der inHostEndPointName- oder inGuestEndpointName-Parameter ist NULL oder kein gültiger Wert. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Ein Handle ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um diese Anforderung abzuschließen. |
|
Das zugrunde liegende System, das zur Bereitstellung von Netzwerkdiensten verwendet wird, wird derzeit initialisiert. |
|
Der Pipename wird bereits verwendet. |
|
Mindestens ein Kanal wird nicht mehr ausgeführt und kann in Kürze verfügbar sein. |
|
Die maximale Anzahl der verfügbaren Kommunikationskanäle wird verwendet. Ein anderer Kanal kann derzeit nicht gestartet werden. |
|
Es besteht ein Konflikt zwischen der Version des Host- und gastsubsystems. Weitere Informationen finden Sie im Windows-Ereignisprotokoll. |
|
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 |
|
| IID |
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert. |