IVMVirtualPC::RegisterVirtualMachine メソッド

  • [アーティクル]

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

既存の仮想マシン構成を登録し、仮想マシン オブジェクトを取得します。

構文

HRESULT RegisterVirtualMachine(
  [in]          BSTR              configurationName,
  [in]          BSTR              configurationPath,
  [out, retval] IVMVirtualMachine **virtualMachine
);

パラメーター

configurationName [in]

登録する仮想マシンの名前。 名前の長さは 80 文字を超えることはできません。また、名前とパスの組み合わせの長さは 、MAX_PATH (260) 文字を超えることはできません。 指定した名前には、.vmc 拡張子を含む場合があります。 このパラメーターが NULL または空の文字列の場合、 configurationPath パラメーターは構成ファイルへの完全なパスを指定する必要があります。

configurationPath [in]

既存の構成ファイルを含むフォルダーへのパス。 configurationName パラメーターが NULL または空の文字列の場合は、既存の構成ファイルへの完全なパスを指定する必要があります。

virtualMachine [out, retval]

この仮想マシンを表す新しい IVMVirtualMachine オブジェクトへのポインター。

戻り値

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

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 configurationName または configurationPath パラメーターが無効であるか、virtualMachine が NULL です。
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 システムは、 configurationName パラメーターと configurationPath パラメーターで指定されたパスを見つけることができません。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 configurationName パラメーターと configurationPath パラメーターで指定されたファイルがシステムで見つかりません。
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 configurationPath パラメーターに無効な文字 ("*?:<>/|"のいずれか) が含まれています。
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 パラメーター configurationPath パラメーターは、空または相対パスを指定します。 絶対パスが必要です。
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 configurationName パラメーターと configurationPath パラメーターで指定されたパスは、長すぎるパスになります。 パスの組み合わせの長さは 、MAX_PATH (260) 文字未満である必要があります。
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 この名前の構成ファイルは、この場所に既に存在します。
VM_E_CONFIG_NAME_TOO_LONG
0xA0040401
 configurationName パラメーターの長さが 80 文字を超えています。
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 configurationName パラメーターに無効な文字 ("*?:<>/|\"のいずれか) が含まれています。
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 この名前の仮想マシンは既に存在します。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 プロセッサは、ハードウェア アクセラレータ仮想化 (HAV) 拡張機能をサポートしていません。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。

解説

仮想マシン名では大文字と小文字が区別されません。たとえば、"MyVM" と "myvm" は同じ仮想マシンを参照します。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
クライアント サポートの終了
 Windows 7
製品
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPCは 236ba0d9-a24a-4292-a132-27c1421dfd01 として定義されています

関連項目

IVMVirtualPC