共用方式為

IVMSerialPort：：Configure 方法

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

設定序列埠。

語法

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

參數

portType [in]

序列埠的類型。 如需值清單，請參閱 VMSerialPortType。

portName [in]

序列埠的名稱。 例如，vmSerialPort_HostPort的 「COM1」、vmSerialPort_TextFile的 「C:\SerialPort.txt」 或vmSerialPort_NamedPipe的 「\\servername\pipe\pipename」。

vmConnectImmediately [in]

如果虛擬機器啟動時應該立即開啟主機序列埠，則為TRUE，否則為FALSE。 如果未vmSerialPort_HostPort portType，則會忽略。

傳回值

這個方法可以傳回其中一個值。

傳回碼/值 描述
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
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMSerialPort定義為 2ce4460d-1d3f-4458-bf8b-44084b816815

另請參閱

IVMSerialPort