Share via


IVMSerialPort::Configure メソッド

[Windows Virtual PC は、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、それ以外の場合は FALSEportTypevmSerialPort_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
Product
Windows Virtual PC
ヘッダー
VPCCOMInterfaces.h
IID
IID_IVMSerialPortは 2ce4460d-1d3f-4458-bf8b-44084b816815 として定義されています

関連項目

IVMSerialPort