Win32ShutdownTracker-Methode der Win32_OperatingSystem-Klasse

Artikel
06/12/2023

Die Win32ShutdownTracker-Methode bietet denselben Satz von Herunterfahroptionen, die von der Win32Shutdown-Methode in Win32_OperatingSystem unterstützt werden, ermöglicht es Ihnen aber auch, Kommentare, einen Grund für das Herunterfahren oder ein Timeout anzugeben.

Syntax

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

Parameter

Timeout [in]: Zeit in Sekunden, bevor das Herunterfahren erfolgt. Der Standardwert ist 0 (null).
Kommentar [in]: Meldung, die im Dialogfeld "Herunterfahren" angezeigt werden soll und auch als Kommentar im Ereignisprotokolleintrag gespeichert wird.
ReasonCode [in]: Grund für das Initiieren des Herunterfahrens.
Flaggen [in]: Bitmaps mit Flags zum Herunterfahren des Computers. Um einen Befehl zu erzwingen, fügen Sie dem Befehlswert das Flag Erzwingen (4) hinzu. Durch Die Verwendung von Erzwingen in Verbindung mit Herunterfahren oder Neustart auf einem Remotecomputer wird sofort alles heruntergefahren (einschließlich WMI, COM usw.), oder der Remotecomputer wird neu gestartet. Dies führt zu einem unbestimmten Rückgabewert.
0 (0x0): Abmelden
4 (0x4): Erzwungenes Abmelden (0 + 4)
1 (0x1): Shutdown
5 (0x5): Erzwungenes Herunterfahren (1 + 4)
2 (0x2): Reboot
6 (0x6): Neustart erzwungen (2 + 4)
8 (0x8): Ausschalten
12 (0xC): Erzwungenes Ausschalten (8 + 4)

Rückgabewert

Gibt null (0) zurück, um den Erfolg anzugeben. Jede andere Zahl gibt einen Fehler an. Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolg (0)
Sonstiges (1–4294967295)

Bemerkungen

Der aufrufende Prozess muss über das SE_SHUTDOWN_NAME-Recht verfügen.

Beispiele

Im folgenden VBScript-Codebeispiel wird beschrieben, wie Win32ShutdownTracker aufgerufen wird.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Betriebssystemklassen
Win32_operatingsystem
Win32Shutdown

Share via