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