IVMVirtualMachine::StartCommunicationChannel メソッド

  • [アーティクル]

[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。

ホスト オペレーティング システムとゲスト オペレーティング システムの間の通信チャネルを設定します。

構文

HRESULT StartCommunicationChannel(
  [in] VMEndpointType inHostEndpointType,
  [in] BSTR           inHostEndPointName,
  [in] VMEndpointType inGuestEndpointType,
  [in] BSTR           inGuestEndpointName
);

パラメーター

inHostEndpointType [in]

このパラメーターは vmEndpoint_NamedPipe (0) である必要があります。

inHostEndPointName [in]

一意のパイプ名。 この文字列の形式は"\\.\pipe\pipename" である必要があります。 名前の pipename 部分には、数値や特殊文字など、円記号以外の任意の文字を含めることができます。 パイプ名の文字列全体の長さは最大 256 文字です。 パイプ名では大文字と小文字は区別されません。

inGuestEndpointType [in]

このパラメーターは vmEndpoint_TCPIP (1) である必要があります。

inGuestEndpointName [in]

ゲストの TCP サーバーがリッスンしているポート番号。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_INVALIDARG
0x80000003
 inHostEndpointType パラメーターが vmEndpoint_NamedPipe (0) ではないか、inGuestEndpointType パラメーターが vmEndpoint_TCPIP (1) ではありません。
E_POINTER
0x80004003
 inHostEndPointName または inGuestEndpointName パラメーターが NULL であるか、有効な値ではありません。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
0x80070006
 ハンドルが無効です。
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 この要求を完了するのに十分なメモリがありません。
HRESULT_FROM_WIN32(ERROR_NOT_READY)
0x80070015
 ネットワーク サービスを提供するために使用する基になるシステムは、現在初期化されています。
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 パイプ名は既に使用されています。
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY)
0x800700e7
 1 つ以上のチャネルが停止しており、まもなく使用可能になる可能性があります。
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED)
0x80070161
 使用可能な通信チャネルの最大数は使用中です。 現時点では、別のチャネルを開始できません。
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH)
0x8007051a
 ホスト サブシステムとゲスト サブシステムのバージョンが一致しません。 詳細については、Windows イベント ログを参照してください。
VM_E_VM_NOT_RUNNING
0xA0040206
 VM が実行されていません。

解説

現在の実装では、ホスト上の名前付きパイプ インターフェイスとゲスト オペレーティング システムの TCP/IP インターフェイスのみがサポートされています。

要件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
クライアント サポートの終了
 Windows 7
Product
 Windows Virtual PC
ヘッダー
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachineは f7092aa1-33ed-4f78-a59f-c00adfc2edd7 として定義されています

関連項目

IVMVirtualMachine

VMEndpointType