Метод Change класса Win32_SystemDriver

Статья
06/13/2023

Метод класса ChangeWMI изменяет службу Win32_SystemDriver . Параметр Win32_LoadOrderGroup представляет группу системных служб, определяющих зависимости выполнения. Службы должны быть инициированы в порядке, указанном группой заказов загрузки, так как службы зависят друг от друга. Для правильной работы этих зависимых служб требуется наличие предшествующих служб.

В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.

Синтаксис

uint32 Change(
  [in] string  DisplayName,
  [in] string  PathName,
  [in] uint8   ServiceType,
  [in] uint8   ErrorControl,
  [in] string  StartMode,
  [in] boolean DesktopInteract,
  [in] string  StartName,
  [in] string  StartPassword,
  [in] string  LoadOrderGroup,
  [in] string  LoadOrderGroupDependencies[],
  [in] string  ServiceDependencies[]
);

Параметры

DisplayName [in]

Отображаемое имя для службы. Максимальная длина этой строки равна 256 символам. Имя сохраняется с учетом регистра в диспетчере управления службами. Сравнение DisplayName всегда не учитывает регистр.

Ограничения: принимает то же значение, что и параметр Name .

Пример: "Atdisk"

PathName [in]

Полный путь к исполняемому файлу, реализующего службу.

Пример :\SystemRoot\System32\drivers\afd.sys

ServiceType [in]

Тип служб, предоставляемых процессам, которые их вызывают.

1 (0x1)

Драйвер ядра

2 (0x2)

Драйвер файловой системы

4 (0x4)

Адаптер

8 (0x8)

Драйвер распознавателя

16 (0x10)

Собственный процесс

32 (0x20)

Процесс предоставления общего доступа

256 (0x100)

Интерактивный процесс

ErrorControl [in]

Серьезность ошибки, если эта служба не запускается во время запуска. Значение указывает действие, выполняемое программой запуска в случае сбоя. Все ошибки регистрируются системой.

Игнорировать (0)

Пользователь не получает уведомление.

Обычный (1)

Нормальный. Пользователь получает уведомление.

Тяжелый (2)

Система перезапускается с последней хорошей конфигурацией.

Критический (3)

Попытка перезапустить систему в рабочей конфигурации.

StartMode [in]

Режим запуска базовой службы Windows.

Запуск загрузки

Драйвер устройства, запущенный загрузчиком операционной системы.

Запуск загрузки

Драйвер устройства, запускаемого загрузчиком операционной системы.

Запуск системы

Драйвер устройства, запущенный процессом инициализации операционной системы. Это значение допустимо только для служб драйверов.

Автозапуск

Служба, автоматически запускаемая диспетчером управления службами во время запуска системы.

Начало запроса

Служба, запускаемая диспетчером управления службой, когда процесс вызывает метод StartService .

Отключен

Служба, которая не может быть запущена.

DesktopInteract [in]

Значение , которое, если значение равно True, служба может создавать окна на рабочем столе или взаимодействовать с ними.

StartName [in]

Имя учетной записи, под которой выполняется служба. В зависимости от типа службы имя учетной записи может иметь вид DomainName\Username или .\Username. При запуске процесс службы регистрируется с помощью одной из этих двух форм. Если учетная запись принадлежит встроенному домену, можно указать .\Username. Если указана пустая строка, служба входит в систему под учетной записью LocalSystem. Для драйверов уровня ядра или системы StartName содержит имя объекта драйвера, например \FileSystem\Rdr или \Driver\Xns), которое система ввода-вывода использует для загрузки драйвера устройства. Если задано значение NULL, драйвер запускается с именем объекта по умолчанию, которое система ввода-вывода создает на основе имени службы, например DWDOM\Администратор.

Вы также можете использовать формат имени участника-пользователя (UPN), чтобы указать startName, например , Username@DomainName.

StartPassword [in]

Пароль для имени учетной записи, указанной параметром StartName . Если вы не изменяете пароль, укажите ЗНАЧЕНИЕ NULL . Если служба не имеет пароля, указывается пустая строка.

Примечание

При изменении службы из локальной системы в сеть или из сети в локальную систему Параметр StartPassword должен быть пустой строкой (""), а не null.

LoadOrderGroup [in]

Имя группы, с которым она связана. Группы порядка загрузки содержатся в системном реестре и определяют последовательность, в которой службы загружаются в операционную систему. Если указатель имеет значение NULL или указывает на пустую строку, служба не принадлежит группе. Зависимости между группами должны быть перечислены в параметре LoadOrderGroupDependencies . Сначала запускаются службы в списке групп упорядочения нагрузки, за ними следуют службы в группах, не входящих в список групп упорядочения нагрузки, а затем службы, которые не принадлежат к группе. Системный реестр содержит список групп упорядочения загрузки, расположенных по адресу:

HKEY_LOCAL_MACHINE\Системы\CurrentControlSet\Управления\ServiceGroupOrder

LoadOrderGroupDependencies [in]

Список групп упорядочения нагрузки, которые должны быть запущены перед запуском этой службы. Массив вдвойне завершается null. Если указатель имеет значение NULL или указывает на пустую строку, служба не имеет зависимостей. Имена групп должны иметь префикс символа SC_GROUP_IDENTIFIER (определенного в файле WinSvc.h), чтобы отличать их от имен служб, так как службы и группы служб используют одно и то же пространство имен. Зависимость от группы означает, что эта служба может запускаться, если после попытки запуска всех членов группы запущен хотя бы один из участников группы.

ServiceDependencies [in]

Список, содержащий имена служб, которые должны быть запущены перед запуском этой службы. Массив вдвойне завершается null. Если указатель имеет значение NULL или указывает на пустую строку, служба не имеет зависимостей. Зависимость от службы означает, что эта служба может выполняться только в том случае, если запущена служба, от которую она зависит.

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

Возвращает значение нуля (0), если служба была успешно изменена, 1 (один), если запрос не поддерживается, и любое другое число, указывающее на ошибку.

Успешно (0)
Не поддерживается (1)
Отказано в доступе (2)
Зависимые службы выполняются (3)
Недопустимый элемент управления службой (4)
Служба не может принять элемент управления (5)
Служба не активна (6)
Время ожидания запроса на обслуживание (7)
Неизвестный сбой (8)
Путь не найден (9)
Служба уже запущена (10)
База данных службы заблокирована (11)
Удалена зависимость службы (12)
Сбой зависимости службы (13)
Служба отключена (14)
Сбой входа в службу (15)
Служба помечена для удаления (16)
Service No Thread (17)
Циклическая зависимость состояния (18)
Повторяющееся имя состояния (19)
Недопустимое имя состояния (20)
Недопустимый параметр состояния (21)
Состояние Недопустимой учетной записи службы (22)
Служба состояния существует (23)
Служба уже приостановлена (24)
Другое (25 4294967295)

Требования

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

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

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

Поделиться через