IVMGuestOS::Restart (método)

[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
);

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.

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.

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.

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