Método Win32ShutdownTracker de la clase Win32_OperatingSystem

El método Win32ShutdownTracker proporciona el mismo conjunto de opciones de apagado admitidas por el método Win32Shutdown en Win32_OperatingSystem, pero también permite especificar comentarios, un motivo de apagado o un tiempo de espera.

Sintaxis

uint32 Win32ShutdownTracker(
  [in] uint32 Timeout,
  [in] string Comment,
  [in] uint32 ReasonCode,
  [in] sint32 Flags
);

Parámetros

Tiempo de espera [in]

Tiempo, en segundos, antes de que se produzca el apagado. El valor predeterminado es 0 (cero).

Comentario [in]

Mensaje que se muestra en el cuadro de diálogo de apagado que también se almacena como comentario en la entrada del registro de eventos.

ReasonCode [in]

Motivo para iniciar el apagado.

Marcas [in]

Conjunto de marcas de mapa de bits para apagar el equipo. Para forzar un comando, agregue la marca Force (4) al valor del comando. El uso de Force junto con Shutdown o Reboot en un equipo remoto cierra inmediatamente todo (incluyendo WMI, COM, etc.) o reinicia el equipo remoto. Esto da como resultado un valor devuelto indeterminado.

0 (0x0)

Cerrar sesión

4 (0x4)

Cierre de sesión forzado (0 + 4)

1 (0x1)

Shutdown

5 (0x5)

Apagado forzado (1 + 4)

2 (0x2)

Reboot

6 (0x6)

Reinicio forzado (2 + 4)

8 (0x8)

Apagar

12 (0xC)

Apagado forzado (8 + 4)

Valor devuelto

Devuelve cero (0) para indicar que se ha realizado correctamente. Cualquier otro número indica que hubo un error. Para ver los códigos de error, consulte Constantes de error WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Correcto (0)

Otros (1–4294967295)

Comentarios

El proceso de llamada debe tener el privilegio SE_SHUTDOWN_NAME .

Ejemplos

En el ejemplo de código de VBScript siguiente se describe cómo llamar a Win32ShutdownTracker.

Set objArgs = Wscript.Arguments 

intTimeOut = objArgs(0) 'Countdown time (in seconds) before action
strComment = objArgs(1) 'Message to display
intFlags = objArgs(2) 'Set of flags to shutdown the computer:
'0 = Logoff, 4 = Forced Logoff (0+4), 1 = Shutdown, 2 = Reboot, 6 = Forced Reboot (2+4), 8 = Power Off, 12 = Forced Power Off (8+4) - 2 (Reboot) 

strComputer = "." 

Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate,(Shutdown)}!\\" & strComputer & "\root\cimv2")

Set colOperatingSystems = objWMIService.ExecQuery ("Select * from Win32_OperatingSystem") 

For Each objOperatingSystem in colOperatingSystems 
objOperatingSystem.Win32ShutdownTracker intTimeOut,strComment,0,intFlags 
Next

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

Clases de sistema operativo

Win32_OperatingSystem

Win32Shutdown