Compartir a través de

IVMGuestOS::Restart (método)

  • 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)].

Reinicia el sistema operativo invitado.

Sintaxis

HRESULT Restart(
  [in]          VARIANT_BOOL inForced,
  [out, retval] IVMTask      **outRestartTask
);

Parámetros

inForced [in]

VARIANT_TRUE si se requiere un reinicio forzado y VARIANT_FALSE de lo contrario.

outRestartTask [out, retval]

Objeto IVMTask que se usa para realizar un seguimiento del progreso de finalización de la secuencia de reinicio.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto Descripción
S_OK
0
 La operación se realizó correctamente.
E_POINTER
0x80004003
 El parámetro outRestartTask es NULL.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.
VM_E_TIMED_OUT
0xA0040202
 La operación no se completó de forma oportuna.
VM_E_VM_NOT_RUNNING
0xA0040206
 La máquina virtual (VM) debe ejecutarse para esta operación.
VM_E_VM_UNKNOWN
0xA0040207
 La configuración es desconocida.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 La característica de componentes de integración no está instalada en esta máquina virtual.

Comentarios

Los valores siguientes se pueden devolver a través de la propiedad Error del objeto IVMTask devuelto.

Código de error /Valor Descripción
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) (0x80070005)
 El autor de la llamada debe tener permisos de acceso de ejecución para esta máquina virtual.
HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED) (0x800704f7)
 El equipo está bloqueado y no se puede apagar sin la opción forzar.
HRESULT_FROM_WIN32(ERROR_NOT_READY) (0x80070015)
 El dispositivo no está listo.
HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS) (0x8007045b)
 El apagado del sistema está en curso.

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_IVMGuestOS se define como 99fea0db-4880-499a-b6d8-73dff9bc91be

Consulte también

IVMGuestOS