Metodo IVMVirtualMachine::StartCommunicationChannel

Articolo
06/13/2023

[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
S_OK 0	L'operazione è stata completata.
E_INVALIDARG 0x80000003	Il parametro inHostEndpointType non è vmEndpoint_NamedPipe (0) o il parametro inGuestEndpointType non è vmEndpoint_TCPIP (1).
E_POINTER 0x80004003	Il parametro inHostEndPointName o inGuestEndpointName è NULL o non è un valore valido.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE) 0x80070006	Handle non valido.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	Memoria insufficiente per completare questa richiesta.
HRESULT_FROM_WIN32(ERROR_NOT_READY) 0x80070015	Il sistema sottostante usato per fornire servizi di rete è attualmente in fase di inizializzazione.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Il nome della pipe è già in uso.
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY) 0x800700e7	Uno o più canali sono in esecuzione e possono diventare disponibili a breve.
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED) 0x80070161	Il numero massimo di canali di comunicazione disponibili è in uso. Al momento non è possibile avviare un altro canale.
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH) 0x8007051a	Esiste una mancata corrispondenza tra la versione dell'host e i sottosistemi guest. Per altri dettagli, vedere registro eventi di Windows.
VM_E_VM_NOT_RUNNING 0xA0040206	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	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine è definito come f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Vedi anche

IVMVirtualMachine
VMEndpointType

Share via