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

Метод 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)

Комментарии

Вызывающий процесс должен иметь привилегию SE_SHUTDOWN_NAME .

Примеры

В следующем примере кода 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

Требования

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

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

Win32_OperatingSystem

Win32Shutdown