次の方法で共有


IVMVirtualMachine::AddHardDiskConnection メソッド

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

仮想マシン (VM) に新しいハード ディスク接続を追加します。

構文

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

パラメーター

hardDiskPath [in]

接続する仮想ハード ディスク (VHD) ファイルの完全パス。

busNumber [in]

ドライブが接続されるバス。

説明
0
ドライブは最初のバスに接続されます。
1
ドライブは 2 番目のバスに接続されます。

deviceNumber [in]

ドライブが接続されるデバイス。

説明
0
ドライブはバス上の最初のデバイスに接続されます。
1
ドライブはバス上の 2 番目のデバイスに接続されます。

hardDiskConnection [out, retval]

IVMHardDiskConnection オブジェクト。

戻り値

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

リターン コード/値 説明
S_OK
0
操作に成功しました。
E_POINTER
0x80004003
hardDiskConnection パラメーターは NULL です
E_INVALIDARG
0x80000003
hardDiskPath パラメーターが NULL であるか、busNumber パラメーターまたは deviceNumber パラメーターが無効です。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
システムは、hardDiskPath パラメーターで指定されたファイルを見つけることができません。
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
システムは、hardDiskPath パラメーターで指定されたパスを見つけることができません。
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
hardDiskPath パラメーターに無効な文字が含まれています ("*?<>/|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
hardDiskPath パラメーターは、空または相対パスを指定します。 絶対パスが必要です。
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
hardDiskPath パラメーターで指定されたパスが長すぎます。 パスは 260 文字未満にする必要があります。
VM_E_VM_UNKNOWN
0xA0040207
構成が不明です。
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
VM が実行中または保存済みの状態です。
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
指定されたバスの場所が使用中です。
VM_E_INVALID_HD_FILE
0xA0040682
VHD は 127 GB を超え、IDE バスに接続できません。
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
hardDiskPath パラメーターは、リンクされた VHD またはリンクされた VHD との差分 VHD を参照します。 リンクされた VHD を仮想マシンにアタッチすることはできません。
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
指定した VHD は、この VM の別のバスの場所に既に接続されています。
DISP_E_EXCEPTION
0x80020009
予期しないエラーが発生しました。

解説

新しいハード ディスク接続は、停止した仮想マシンにのみ追加できます。

必要条件

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

関連項目

IVMVirtualMachine