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
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Vedi anche