Metodo IVMSerialPort::Configure

[Windows Virtual PC non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Configura la porta seriale.

Sintassi

HRESULT Configure(
  [in] VMSerialPortType portType,
  [in] BSTR             portName,
  [in] VARIANT_BOOL     vmConnectImmediately
);

portType [in]: Tipo di porta seriale. Per un elenco di valori, vedere VMSerialPortType.
portName [in]: Nome della porta seriale. Ad esempio, "COM1" per vmSerialPort_HostPort, "C:\SerialPort.txt" per vmSerialPort_TextFile o "\nomeserver\pipe\pipename" per vmSerialPort_NamedPipe.
vmConnectImmediately [in]: TRUE se la porta seriale host deve essere aperta immediatamente quando viene avviata la macchina virtuale e FALSE in caso contrario. Ignorato se portType non è vmSerialPort_HostPort.

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	L'operazione è stata completata.
E_INVALIDARG 0x80000003	Il parametro portType non è valido.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.
E_POINTER 0x80004003	Il parametro portName è NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	Memoria insufficiente per completare questa richiesta.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Il percorso specificato dal parametro portName è troppo lungo. Il percorso deve essere minore di MAX_PATH (260) caratteri.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Il parametro portName contiene un carattere non valido (uno di "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Il parametro portName specifica un percorso vuoto o relativo. È necessario un percorso assoluto.
VM_E_VM_UNKNOWN 0xA0040207	La configurazione per questa macchina virtuale non è valida.
VM_E_PREF_ILLEGAL_VALUE 0xA0040301	La porta specificata è già in uso.

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_IVMSerialPort è definito come 2ce4460d-1d3f-4458-bf8b-44084b816815