通过

IVMSerialPort：：Configure 方法

  • 项目

[自Windows 8起，Windows 虚拟电脑不再可供使用。 请改用 Hyper-V WMI 提供程序 (V2) 。]

配置串行端口。

语法

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

parameters

portType [in]

串行端口的类型。 有关值列表，请参阅 VMSerialPortType。

portName [in]

串行端口的名称。 例如，“COM1”用于 vmSerialPort_HostPort，“C:\SerialPort.txt”用于 vmSerialPort_TextFile，“\\servername\pipe\pipe”用于 vmSerialPort_NamedPipe。

vmConnectImmediately [in]

如果启动虚拟机时应立即打开主机串行端口，则为 TRUE;否则为 FALSE。 如果未vmSerialPort_HostPortportType，则忽略。

返回值

此方法可以返回其中一个值。

返回代码/值 说明
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