Метод GetSecurityDescriptor класса Win32_Service (поставщики WMI CIMWin32)

Статья
10/11/2023

Метод GetSecurityDescriptor возвращает дескриптор безопасности, который управляет доступом к службе. Дескриптор возвращается как экземпляр Win32_SecurityDescriptor.

Синтаксис

uint32 GetSecurityDescriptor(
  [out] Win32_SecurityDescriptor Descriptor
);

Параметры

Дескриптор [out]: Дескриптор безопасности, связанный со службой.

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

Возвращает одно из значений, перечисленных в следующем списке, или другое значение, указывающее ошибку. Дополнительные коды ошибок см. в разделе "Константы ошибок WMI" или WbemErrorEnum. Общие значения HRESULT см. в разделе "Коды системных ошибок".

Успешно

Запрос принят.

Запрос не поддерживается.

Доступ запрещен

У пользователя не было необходимого доступа.

Службу нельзя остановить, так как от нее зависят другие работающие службы.

Запрошенный управляющий код недопустим или неприемлем для данной службы.

Запрошенный код элемента управления не может быть отправлен в службу, так как состояние службы (Win32_BaseService.Свойство State ) равно 0, 1 или 2.

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

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

Неизвестный сбой

Неизвестный сбой при запуске службы.

Отсутствие привилегий

Путь к исполняемому файлу службы не найден.

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

База данных для добавления новой службы заблокирована.

Зависимость этой службы зависит от того, была удалена из системы.

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

Эта служба была отключена в системе.

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

Эта служба удаляется из системы.

Служба не имеет потока выполнения.

Служба имеет циклические зависимости при запуске.

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

Имя службы содержит недопустимые символы.

Недопустимый параметр

Недопустимые параметры переданы службе.

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

Служба существует в базе данных доступных в системе служб.

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

Прочее

22 4294967295

Замечания

Экземпляр Win32_SecurityDescriptor представляет тип данных SECURITY_DESCRIPTOR_CONTROL и содержит список управления доступом (DACL) и список системного управления доступом (SACL). Дополнительные сведения см. в контроль доступа списках.

Если SeSecurityPrivilege не предоставляется или включен при получении дескриптора безопасности, то в дескрипторе безопасности возвращается только DACL. Дополнительные сведения см. в разделе "Константы привилегий" и "Выполнение привилегированных операций".

Примеры

При получении дескриптора безопасности в VBScript обязательно выполните команду Security и запустите как Администратор, как показано в следующем фрагменте кода. В противном случае код может вызвать ошибку разрешений.

Set objWMIService = GetObject("winmgmts:" _
  & "{impersonationLevel=impersonate, (Security)}!\\" & strComputer & "\root\cimv2")

Аналогичным образом в VB.NET обязательно установите значение EnablePrivileges = True и запустите приложение как Администратор.

Scope = New ManagementScope([String].Format("\\{0}\root\CIMV2", ComputerName), Nothing)
Scope.Options.EnablePrivileges = True

Требования

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

См. также

Win32_Service
Константы привилегий
Объекты дескриптора безопасности WMI
Изменение безопасности доступа в защищаемых объектах
Управление учетными записями пользователей и WMI