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
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

Betriebssystemklassen

Win32 _ OperatingSystem

Win32Shutdown