Compartir a través de

Propiedad IVMVirtualMachine::Name

  • Artículo

[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2)].

Recupera y establece el nombre de la configuración de la máquina virtual.

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

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

Valor de propiedad

Especifica el nombre de la configuración de la máquina virtual. La longitud del nombre no puede tener más de 80 caracteres y la longitud total de la ruta de acceso completa que incluye el archivo de configuración del nombre de la máquina virtual no puede tener más de MAX_PATH (260).

Códigos de error

Nombre o valor Significado
S_OK
0
 La operación se realizó correctamente.
E_POINTER
0x80004003
 El parámetro es NULL.
E_INVALIDARG
0x80000003
 El parámetro no es válido o es una cadena vacía.
VM_E_VM_UNKNOWN
0xA0040207
 La configuración es desconocida.
VM_E_PREF_VM_ACTIVE
0xA0040302
 La máquina virtual se está ejecutando o guardando.
VM_E_CONFIG_NO_NAME
0xA0040400
 El parámetro virtualMachineName está vacío.
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
 El parámetro contiene demasiados caracteres.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 El parámetro contiene uno de los siguientes caracteres no válidos "*?:<>/|\"".
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 El nombre especificado ya existe como nombre de otra máquina virtual.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Comentarios

Los nombres de máquina virtual no distinguen mayúsculas de minúsculas; por ejemplo, "MyVM" y "myvm" hacen referencia a la misma máquina virtual. Esta es la propiedad predeterminada para IVMVirtualMachine.

Si VPC.exe se está ejecutando y la máquina virtual se guarda, el establecimiento de la propiedad Name no se realizará correctamente. Si VPC.exe no se está ejecutando y la máquina virtual se guarda, el establecimiento de la propiedad Name se realizará correctamente cuando se inicie VPC.exe siguiente.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Fin de compatibilidad de cliente
 Windows 7
Producto
 Windows Virtual PC
Encabezado
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine se define como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Consulte también

IVMVirtualMachine