класс Win32_BaseService

  • Статья

Абстрактный класс WMIWin32_BaseService представляет исполняемые объекты, установленные в базе данных реестра, поддерживаемой диспетчером управления службами. Исполняемый файл, связанный со службой, может быть запущен во время загрузки программой загрузки или системой. Диспетчер управления службами также может запускать его по запросу. Любая служба или процесс, не принадлежащий конкретному пользователю и предоставляющий интерфейс для некоторых функций, поддерживаемых компьютерной системой, является потомком (или членом) этого класса.

Пример: служба dhcp-клиента в компьютерной системе под управлением Windows Server.

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

Синтаксис

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  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_BaseService имеет следующие типы членов:

Методы

Класс Win32_BaseService содержит эти методы.

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

Свойства

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

AcceptPause

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Структуры служб | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Service Accepts Pause")

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

AcceptStop

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Структуры служб | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service Accepts Stop")

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

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 ("Взаимодействует с рабочим столом")

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

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

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Структуры служб | QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Отображаемое имя")

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

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

Пример: "Atdisk"

ErrorControl

Тип данных: string

Тип доступа: только для чтения

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

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

Ignore ("Ignore")

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

Обычный ("Обычный")

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

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

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

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

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

Unknown ("Unknown")

Выполненные действия не указаны.

ExitCode

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Код выхода")

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

InstallDate

Тип данных: datetime

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

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

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

имя;

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Ключ

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

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

PathName

Тип данных: string

Тип доступа: только для чтения

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

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

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

ServiceSpecificExitCode

Тип данных: uint32

Тип доступа: только для чтения

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

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

ServiceType

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Тип службы")

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

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

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

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

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

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

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

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

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

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: DisplayName ("Started")

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

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

StartMode

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Override ("StartMode"), DisplayName ("Start Mode")

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

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

Boot ("Boot")

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

System ("System")

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

Auto ("Auto")

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

Manual ("Manual")

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

Disabled ("Disabled")

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

StartName

Тип данных: string

Тип доступа: только для чтения

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

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

Состояние

Тип данных: string

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

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

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

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

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

Running ("Running")

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

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

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

Unknown ("Unknown")

Windows Server 2008 и Windows Vista: Это свойство доступно только для чтения.

Состояние

Тип данных: 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 (ноль) означает, что службе не назначен тег. Тег можно использовать для упорядочения star службы в группе заказов загрузки, указав вектор порядка тегов в реестре, расположенном по адресу HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. Теги оцениваются только для служб типа запуска драйвера ядра и драйвера файловой системы, имеющих режимы загрузки или запуска системы.

Комментарии

Класс Win32_BaseService является производным от CIM_Service.

Требования

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

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

CIM_Service

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