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