Метод SWbemPrivilegeSet.Add

  • Статья

Метод Add объекта SWbemPrivilegeSet добавляет объект SWbemPrivilege в коллекцию SWbemPrivilegeSet . Если привилегия с таким именем уже существует в коллекции, она заменяется.

Описание этого синтаксиса см. в разделе Соглашения о документах для API скриптов.

Синтаксис

objPrivilege = .Add( _
  ByVal iPrivilege, _
  [ ByVal bIsEnabled ] _
)

Параметры

iPrivilege

Обязательный. Одна из констант WMI из группы WbemPrivilegeEnum . По сути, эти константы являются целыми числами, представляющими определенные привилегии. Например, чтобы добавить привилегию, позволяющую завершить работу компьютерной системы, используйте константу wbemPrivilegeShutdown . В скрипте необходимо использовать числовой эквивалент 23 (0x17). Полный список этих констант и связанных строк привилегий см. в разделе Константы привилегий.

bIsEnabled [необязательно]

Логическое значение, которое включает или отключает эту привилегию. Значение по умолчанию — TRUE.

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

В случае успешного выполнения метод возвращает объект SWbemPrivilege , представляющий новую привилегию. В противном случае возвращается объект NULL.

Коды ошибок

После завершения метода Add объект Err может содержать код ошибки из следующего списка.

wbemErrFailed — 2147749889 (0x80041001)

Незаданная ошибка.

Примеры

Пример кода, использующий этот метод, описан в разделе SWbemPrivilegeSet .

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Заголовок
Wbemdisp.h
Библиотека типов
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
 CLSID_SWbemPrivilegeSet
IID
 IID_ISWbemPrivilegeSet

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

SWbemPrivilegeSet

Выполнение привилегированных операций

Выполнение привилегированных операций с помощью VBScript

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Константы привилегий