Метод Win32ShutdownTracker класса Win32_OperatingSystem

Статья
06/12/2023

Метод Win32ShutdownTracker предоставляет тот же набор параметров завершения работы, который поддерживается методом Win32Shutdown в Win32_OperatingSystem, но также позволяет указать комментарии, причину завершения работы или время ожидания.

Синтаксис

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

Параметры

Время ожидания [в]: Время (в секундах) до завершения работы. Значение по умолчанию — 0 (нуль).
Комментарий [в]: Сообщение для отображения в диалоговом окне завершения работы, которое также хранится в качестве комментария в записи журнала событий.
ReasonCode [in]: Причина инициации завершения работы.
Флаги [in]: Набор битовых флагов для завершения работы компьютера. Чтобы принудить команду, добавьте в значение команды флаг Force (4). Использование force в сочетании с завершением работы или перезагрузкой на удаленном компьютере немедленно завершает работу всех компонентов (включая WMI, COM и т. д.) или перезагружает удаленный компьютер. В результате возвращается неопределенное значение.
0 (0x0): Выход из системы
4 (0x4): Принудительный выход (0 + 4)
1 (0x1): Завершить работу
5 (0x5): Принудительное завершение работы (1 + 4)
2 (0x2): Перезагрузка
6 (0x6): Принудительная перезагрузка (2 + 4)
8 (0x8): Выключение
12 (0xC): Принудительное выключение питания (8 + 4)

Возвращаемое значение

Возвращает ноль (0), чтобы указать на успешное выполнение. Любое другое значение указывает на ошибку. Коды ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.

Успешно (0)
Другое (1–4294967295)

Примеры

В следующем примере кода VBScript описывается вызов 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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

Классы операционной системы
Win32_OperatingSystem
Win32Shutdown