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 として定義されています