Método Win32ShutdownTracker da classe Win32_OperatingSystem

O método Win32ShutdownTracker fornece o mesmo conjunto de opções de desligamento com suporte pelo método Win32Shutdown em Win32_OperatingSystem, mas também permite que você especifique comentários, um motivo para desligamento ou um tempo limite.

Sintaxe

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

Parâmetros

Tempo limite [in]

Tempo, em segundos, antes que o desligamento ocorra. O valor padrão é 0 (zero).

Comentário [in]

Mensagem a ser exibida na caixa de diálogo desligamento que também é armazenada como um comentário na entrada do log de eventos.

ReasonCode [in]

Motivo para iniciar o desligamento.

Sinalizadores [in]

Conjunto bitmizado de sinalizadores para desligar o computador. Para forçar um comando, adicione o sinalizador Force (4) ao valor de comando. O uso do Force em conjunto com Desligamento ou Reinicialização em um computador remoto desliga imediatamente tudo (incluindo WMI, COM e assim por diante) ou reinicializa o computador remoto. Isso resulta em um valor retornado indeterminado.

0 (0x0)

Fazer logoff

4 (0x4)

Log Off forçado (0 + 4)

1 (0x1)

Shutdown

5 (0x5)

Desligamento forçado (1 + 4)

2 (0x2)

Reboot

6 (0x6)

Reinicialização forçada (2 + 4)

8 (0x8)

Desligar

12 (0xC)

Desligar forçada (8 + 4)

Valor retornado

Retorna zero (0) para indicar êxito. Qualquer outro número indica um erro. Para obter códigos de erro, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Sucesso (0)

Outros (1 a 4294967295)

Comentários

O processo de chamada deve ter o privilégio SE_SHUTDOWN_NAME .

Exemplos

O exemplo de código VBScript a seguir descreve como chamar 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	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_operatingsystem

Win32Shutdown