Win32ShutdownTracker-Methode der Win32 _ OperatingSystem-Klasse
Die Win32ShutdownTracker-Methode stellt die gleichen Herunterfahroptionen bereit, die von der Win32Shutdown-Methode in Win32 _ OperatingSystemunterstützt werden. Sie können aber auch Kommentare, einen Grund für das Herunterfahren oder ein Timeout angeben.
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 zum Herunterfahren angezeigt wird, das auch als Kommentar im Ereignisprotokolleintrag gespeichert ist.
-
ReasonCode [ In]
-
Grund für das Initiieren des Herunterfahrens.
-
Flags [ In]
-
Ein Bitmapsatz von Flags zum Herunterfahren des Computers. Um einen Befehl zu erzwingen, fügen Sie dem Befehlswert das Flag Force (4) hinzu. Wenn Sie Force in Verbindung mit Herunterfahren oder Neustart auf einem Remotecomputer verwenden, 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)
-
Erzwungene Abmeldung (0 + 4)
-
1 (0x1)
-
Herunterfahren
-
5 (0x5)
-
Erzwungenes Herunterfahren (1 + 4)
-
2 (0x2)
-
Reboot
-
6 (0x6)
-
Erzwungener Neustart (2 + 4)
-
8 (0x8)
-
Ausschalten
-
12 (0xC)
-
Erzwungenes Ausschalten (8 + 4)
Rückgabewert
Gibt 0 (null) 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)
Hinweise
Der aufrufende Prozess muss über die berechtigung SE _ SHUTDOWN _ NAME 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) |
Windows Server 2008 |
| Namespace |
Stamm \ CIMV2 |
| MOF |
|
| DLL |
|