IVMSerialPort::Configure-Methode

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Konfiguriert den seriellen Port.

Syntax

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

portType [in]: Der Typ des seriellen Ports. Eine Liste der Werte finden Sie unter VMSerialPortType.
portName [in]: Der Name des seriellen Ports. Beispielsweise "COM1" für vmSerialPort_HostPort, "C:\SerialPort.txt" für vmSerialPort_TextFile oder "\\servername\pipe\pipe\pipename" für vmSerialPort_NamedPipe.
vmConnectImmediately [in]: TRUE , wenn der serielle Hostport sofort geöffnet werden soll, wenn der virtuelle Computer gestartet wird, andernfalls FALSE . Wird ignoriert, wenn portType nicht vmSerialPort_HostPort ist.

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_INVALIDARG 0x80000003	Der portType-Parameter ist ungültig.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.
E_POINTER 0x80004003	Der portName-Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	Es ist nicht genügend Arbeitsspeicher verfügbar, um diese Anforderung auszuführen.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Der vom portName-Parameter angegebene Pfad ist zu lang. Der Pfad muss kleiner als MAX_PATH (260) Zeichen sein.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Der portName-Parameter enthält ein ungültiges Zeichen (eines von "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Der portName-Parameter gibt einen leeren oder relativen Pfad an. Ein absoluter Pfad ist erforderlich.
VM_E_VM_UNKNOWN 0xA0040207	Die Konfiguration für diesen virtuellen Computer ist ungültig.
VM_E_PREF_ILLEGAL_VALUE 0xA0040301	Der angegebene Port wird bereits verwendet.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Ende des Supports (Client)	Windows 7
Produkt	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMSerialPort ist definiert als 2ce4460d-1d3f-4458-bf8b-44084b816815