Поделиться через

Метод IVMSerialPort::Configure

  • Статья

[Виртуальный компьютер Windows больше недоступен для использования с Windows 8. Вместо этого используйте поставщик WMI Hyper-V (V2).]

Настраивает последовательный порт.

Синтаксис

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

Параметры

portType [in]

Тип последовательного порта. Список значений см. в разделе VMSerialPortType.

portName [in]

Имя последовательного порта. Например, "COM1" для vmSerialPort_HostPort, "C:\SerialPort.txt" для vmSerialPort_TextFile или "\\servername\pipe\pipename" для vmSerialPort_NamedPipe.

vmConnectImmediately [in]

Значение TRUE , если последовательный порт узла должен быть открыт немедленно при запуске виртуальной машины, и false в противном случае. Игнорируется, если portType не vmSerialPort_HostPort.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемый код или значение Описание
S_OK
0
 Операция выполнена успешно.
E_INVALIDARG
0x80000003
 Недопустимый параметр portType .
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.
E_POINTER
0x80004003
 Параметр portName имеет значение NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 Недостаточно памяти для выполнения этого запроса.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Слишком длинный путь, указанный параметром portName . Путь должен быть меньше MAX_PATH (260) символов.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Параметр portName содержит недопустимый символ (один из "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Параметр portName указывает пустой или относительный путь. Требуется абсолютный путь.
VM_E_VM_UNKNOWN
0xA0040207
 Недопустимая конфигурация для этой виртуальной машины.
VM_E_PREF_ILLEGAL_VALUE
0xA0040301
 Указанный порт уже используется.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMSerialPort определяется как 2ce4460d-1d3f-4458-bf8b-44084b816815

См. также раздел

IVMSerialPort