Compartir a través de

Método IVMGuestOS::Shutdown

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

Apaga el sistema operativo invitado en la máquina virtual (VM).

Sintaxis

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

Parámetros

isForced [in]

VARIANT_TRUE si se va a forzar el apagado, VARIANT_FALSE de lo contrario.

outShutdownTask [out, retval]

Objeto IVMTask que se usa para realizar un seguimiento de la finalización del proceso de apagado.

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 outShutdownTask es NULL.
VM_E_TIMED_OUT
0xA0040202
 La operación no se completó de forma oportuna.
VM_E_VM_UNKNOWN
0xA0040207
 No se encontró la máquina virtual.
VM_E_VM_NOT_RUNNING
0xA0040206
 La máquina virtual debe ejecutarse para esta operació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.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 La característica de componentes de integración no está instalada en esta máquina virtual.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Comentarios

La máquina virtual debe ejecutarse y la característica de componentes de integración debe instalarse cuando se invoca este método. Este método solo se admite para los sistemas operativos invitados basados en Windows.

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 force.
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