共用方式為

IVMVirtualMachine：：Name 屬性

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

擷取並設定虛擬機器組態的名稱。

這是可讀寫的屬性。

Syntax

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
標頭
VPCOMInterfaces.h
IID
 IID_IVMVirtualMachine定義為 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另請參閱

IVMVirtualMachine