Метод 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 |
| Заголовок |
|
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_SWbemPrivilegeSet |
| IID |
IID_ISWbemPrivilegeSet |