Metodo Win32ShutdownTracker della classe Win32_OperatingSystem

Il metodo Win32ShutdownTracker fornisce lo stesso set di opzioni di arresto supportate dal metodo Win32Shutdown in Win32_OperatingSystem, ma consente anche di specificare commenti, un motivo per l'arresto o un timeout.

Sintassi

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

Parametri

Timeout [in]

Tempo, in secondi, prima dell'arresto. Il valore predefinito è 0 (zero).

Commento [in]

Messaggio da visualizzare nella finestra di dialogo di arresto archiviato anche come commento nella voce del registro eventi.

ReasonCode [in]

Motivo dell'avvio dell'arresto.

Flag [in]

Set di flag bitmap per arrestare il computer. Per forzare un comando, aggiungere il flag Force (4) al valore del comando. L'uso di Force in combinazione con arresto o riavvio in un computer remoto arresta immediatamente tutto (inclusi WMI, COM e così via) o riavvia il computer remoto. Ciò comporta un valore restituito indeterminato.

0 (0x0)

Disconnettersi

4 (0x4)

Disconnessione forzata (0 + 4)

1 (0x1)

Shutdown

5 (0x5)

Arresto forzato (1 + 4)

2 (0x2)

Riavvio

6 (0x6)

Riavvio forzato (2 + 4)

8 (0x8)

Spegni

12 (0xC)

Spegnimento forzato (8 + 4)

Valore restituito

Restituisce zero (0) per indicare l'esito positivo. Qualsiasi altro numero indica un errore. Per i codici di errore, vedere Costanti errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Operazione riuscita (0)

Altro (1-4294967295)

Commenti

Il processo chiamante deve avere il privilegio SE_SHUTDOWN_NAME .

Esempio

L'esempio di codice VBScript seguente descrive come chiamare 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

Requisiti

Vedi anche

Classi del sistema operativo

Win32_OperatingSystem

Win32Shutdown