Metodo IVMVirtualMachine::StartCommunicationChannel
[PC virtuale Windows non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]
Configura un canale di comunicazione tra host e sistema operativo guest.
Sintassi
HRESULT StartCommunicationChannel(
[in] VMEndpointType inHostEndpointType,
[in] BSTR inHostEndPointName,
[in] VMEndpointType inGuestEndpointType,
[in] BSTR inGuestEndpointName
);
Parametri
-
inHostEndpointType [in]
-
Questo parametro deve essere vmEndpoint_NamedPipe (0).
-
inHostEndPointName [in]
-
Nome della pipe univoco. Questa stringa deve avere il formato seguente: "\\.\pipe\pipename". La parte pipename del nome può includere qualsiasi carattere diverso da una barra rovesciata, inclusi numeri e caratteri speciali. L'intera stringa del nome della pipe può contenere fino a 256 caratteri. I nomi delle pipe non fanno distinzione tra maiuscole e minuscole.
-
inGuestEndpointType [in]
-
Questo parametro deve essere vmEndpoint_TCPIP (1).
-
inGuestEndpointName [in]
-
Numero di porta in cui il server TCP nel guest è in ascolto.
Valore restituito
Questo metodo può restituire uno di questi valori.
Codice/valore restituito | Descrizione |
---|---|
|
L'operazione è stata completata. |
|
Il parametro inHostEndpointType non è vmEndpoint_NamedPipe (0) o il parametro inGuestEndpointType non è vmEndpoint_TCPIP (1). |
|
Il parametro inHostEndPointName o inGuestEndpointName è NULL o non è un valore valido. |
|
Si è verificato un errore imprevisto. |
|
Handle non valido. |
|
Memoria insufficiente per completare questa richiesta. |
|
Il sistema sottostante usato per fornire servizi di rete è attualmente in fase di inizializzazione. |
|
Il nome della pipe è già in uso. |
|
Uno o più canali sono in esecuzione e possono diventare disponibili a breve. |
|
Il numero massimo di canali di comunicazione disponibili è in uso. Al momento non è possibile avviare un altro canale. |
|
Esiste una mancata corrispondenza tra la versione dell'host e i sottosistemi guest. Per altri dettagli, vedere registro eventi di Windows. |
|
La macchina virtuale non è in esecuzione. |
Commenti
L'implementazione corrente supporta solo l'interfaccia named pipe nell'host e nell'interfaccia TCP/IP nel sistema operativo guest.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 7 [solo app desktop] |
Server minimo supportato |
Nessuno supportato |
Fine del supporto client |
Windows 7 |
Prodotto |
Windows Virtual PC |
Intestazione |
|
IID |
IID_IVMVirtualMachine è definito come f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |