Класс Win32_SystemDriver

Статья
06/12/2023

Класс WMIWin32_SystemDriver представляет системный драйвер для базовой службы.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства и методы находятся в алфавитном порядке, а не в порядке MOF.

Синтаксис

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

Члены

Класс Win32_SystemDriver имеет следующие типы членов:

Методы
Свойства

Методы

Класс Win32_SystemDriver содержит следующие методы.

Метод	Описание
Изменить	Метод класса, изменяющий службу.
ChangeStartMode	Метод класса, изменяющий режим запуска службы.
Создать	Метод класса, который создает новую службу.
Удалить	Метод класса, который удаляет существующую службу.
Запрос службы	Метод класса, который запрашивает, чтобы служба обновила свое состояние диспетчера служб.
PauseService	Метод класса, который пытается поместить службу в приостановленное состояние.
ResumeService	Метод класса, который пытается поместить службу в возобновленное состояние.
StartService	Метод класса, который пытается поместить службу в состояние запуска.
StopService	Метод класса, который переводит службу в остановленное состояние.
UserControlService	Метод класса, который пытается отправить определяемый пользователем управляющий код в службу.

Свойства

Класс Win32_SystemDriver имеет следующие свойства.

AcceptPause

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Служба принимает паузу")

Служба может быть приостановлена.

Это свойство наследуется от Win32_BaseService.

AcceptStop

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Служба принимает остановку")

Служба может быть остановлена.

Это свойство наследуется от Win32_BaseService.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

CreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key, DisplayName ("Имя класса")

Имя первого конкретного класса, отображаемого в цепочке наследования, используемой при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры этого класса и его подклассы.

Это свойство наследуется от CIM_Service.

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

DesktopInteract

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Взаимодействует с рабочим столом")

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

Это свойство наследуется от Win32_BaseService.

Отображаемое имя

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Отображаемое имя")

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

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

Пример: "Atdisk"

Это свойство наследуется от Win32_BaseService.

ErrorControl

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Серьезность сбоя при запуске")

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

Это свойство наследуется от Win32_BaseService.

Ignore ("Ignore")

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

Normal ("Normal")

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

Тяжелый ("Тяжелый")

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

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

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

Unknown ("Unknown")

Причина сбоя неизвестна.

ExitCode

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Код выхода")

Код ошибки Windows, определяющий все проблемы, возникшие при запуске или остановке службы. Этому свойству присваивается значение ERROR_SERVICE_SPECIFIC_ERROR (1066), если ошибка является уникальной для службы, представленной этим классом, а сведения об ошибке доступны в свойстве ServiceSpecificExitCode . Служба задает для этого значения значение NO_ERROR при запуске и снова при обычном завершении работы.

Это свойство наследуется от Win32_BaseService.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Объект установлен. Этому свойству не требуется значение, указывающее, что объект установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Ключ

Уникальный идентификатор службы, который указывает на управляемые функциональные возможности. Эта функция подробно описана в свойстве Описание объекта.

Это свойство наследуется от CIM_Service.

PathName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Имя пути к файлу")

Полный путь к двоичному файлу службы, который реализует службу.

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

Это свойство наследуется от Win32_BaseService.

ServiceSpecificExitCode

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Код выхода для конкретного сервера")

Код ошибки службы для ошибок, возникающих во время запуска или остановки службы. Коды выхода определяются службой, представленной этим классом. Это значение задается, только если свойство ExitCodeимеет значение ERROR_SERVICE_SPECIFIC_ERROR (1066).

Это свойство наследуется от Win32_BaseService.

ServiceType

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Тип службы")

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

Это свойство наследуется от Win32_BaseService.

Значения качества производительности:

Драйвер ядра ("Драйвер ядра")

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

Адаптер ("Адаптер")

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

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

Общий процесс ("Процесс предоставления общего доступа")

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

Приступая к работе

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Started")

Служба запущена.

Это свойство наследуется от CIM_Service.

StartMode

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Режим запуска")

Режим запуска системного драйвера.

Это свойство наследуется от Win32_BaseService.

Boot ("Boot")

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

System ("System")

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

Auto ("Auto")

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

Manual ("Manual")

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

Disabled ("Disabled")

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

StartName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Имя стартовой учетной записи")

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

Пример: "DWDOM\Администратор"

Это свойство наследуется от Win32_BaseService.

Состояние

Тип данных: string
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

Текущее состояние базовой службы.

Это свойство наследуется от Win32_BaseService.

Значения качества производительности:

Остановлено ("Остановлено")

Ожидание запуска ("Ожидание запуска")

Остановить ожидание ("Остановить ожидание")

Running ("Running")

Продолжить ожидание ("Продолжить в ожидании")

Приостановка ожидания ("Пауза в ожидании")

Приостановлено ("Приостановлено")

Unknown ("Unknown")

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Текущее состояние объекта. Можно определить различные операционные и нерабочие состояния. Операционные состояния: "ОК", "Понижено" и "Сбой pred" (элемент, например жесткий диск с поддержкой SMART, может работать правильно, но прогнозирует сбой в ближайшем будущем). К нерабочим состояниям относятся: "Ошибка", "Запуск", "Остановка" и "Служба". Последняя служба может применяться во время зеркало повторного изменения диска, перезагрузки списка разрешений пользователя или других административных действий. Не вся такая работа находится в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

Значения качества производительности:

ОК ("ОК")

Error ("Error")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Запуск")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

SystemCreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Имя класса системы")

Имя типа системы, в котором размещена эта служба.

Это свойство наследуется от CIM_Service.

SystemName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key, DisplayName ("System Name")

Имя системы, в котором размещена эта служба.

Это свойство наследуется от CIM_Service.

TagId

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Идентификатор тега")

Уникальное значение тега для этой службы в группе. Значение 0 (ноль) означает, что службе не назначен тег. Тег можно использовать для запуска службы заказов в группе заказов загрузки, указав вектор порядка тегов в реестре, расположенном по адресу:

Это свойство наследуется от Win32_BaseService.

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList.

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

Примеры

Пример перечисления системных драйверов VBScript Отображает установленные системные драйверы в HTML-файле.

В следующем примере PowerShell извлекается ряд свойств из работающих системных драйверов на компьютере.

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

Требования

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

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

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

Класс Win32_SystemDriver

Синтаксис

Члены

Методы

Свойства

Комментарии

Примеры

Требования

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

Обратная связь

Обратная связь

Дополнительные ресурсы