IVMVirtualMachine::Name プロパティ

  • [アーティクル]

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

仮想マシン構成の名前を取得して設定します。

このプロパティは読み取り/書き込み可能です。

構文

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

HRESULT get_Name(
  [out, retval] BSTR *virtualMachineName
);

プロパティ値

仮想マシン構成の名前を指定します。 名前の長さは 80 文字を超えることはできません。また、仮想マシン名構成ファイルを含む完全修飾パスの長さの合計は 、MAX_PATH (260) 文字を超えることはできません。

エラー コード

名前/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 パラメーターは NULL です。
E_INVALIDARG
0x80000003
 パラメーターが無効であるか、空の文字列です。
VM_E_VM_UNKNOWN
0xA0040207
 構成が不明です。
VM_E_PREF_VM_ACTIVE
0xA0040302
 仮想マシンが実行されているか、保存されています。
VM_E_CONFIG_NO_NAME
0xA0040400
 virtualMachineName パラメーターが空です。
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
 パラメーターに含まれる文字が多すぎます。
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 パラメーターには、次のいずれかの無効な文字 "*?:<>/|\" が含まれています。
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 指定した名前は、別の仮想マシンの名前として既に存在します。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。

解説

仮想マシン名では大文字と小文字が区別されません。たとえば、"MyVM" や "myvm" は同じ仮想マシンを参照します。 これは IVMVirtualMachine の既定のプロパティです。

VPC.exeが実行されていて、VM が保存されている場合、 Name プロパティの設定は成功しません。 VPC.exeが実行されておらず、VM が保存されている場合、次にVPC.exeが開始されたときに Name プロパティの設定は成功します。

必要条件

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

関連項目

IVMVirtualMachine