Метод SWbemPrivilegeSet.AddAsString

  • Статья

Вы можете использовать метод AddAsString объекта SWbemPrivilegeSet , чтобы добавить привилегию к коллекции SWbemPrivilegeSet с помощью строки привилегий. Используйте этот метод, чтобы добавить привилегию или включить привилегию для объектов SWbemSecurity . См. раздел Выполнение привилегированных операций с помощью VBScript.

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

Синтаксис

objPrivilege = .AddAsString( _
  ByVal strPrivilege, _
  [ ByVal bIsEnabled ] _
)

Параметры

strPrivilege

Обязательный. Одна из строк привилегий. Полный список этих строк и связанных констант WMI см. в разделе Константы привилегий. Каждая строка привилегий представляет определенную привилегию. Например, чтобы добавить привилегию, которая используется для завершения работы компьютерной системы, используйте строку SeShutdownPrivilege .

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

Логическое значение, которое включает или отключает эту привилегию. По умолчанию используется значение True.

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

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

Коды ошибок

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

wbemErrFailed — 2147749889 (0x80041001)

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

Примеры

В следующем примере кода VBScript создается новый порт для сервера печати с помощью Win32_TCPIPPrinterPort. Для этой операции требуется SeLoadDriverPrivilege . См. раздел Выполнение привилегированных операций.

Set objWMIService = GetObject("Winmgmts:")
objWMIService.Security_.Privileges. _
    AddAsString "SeLoadDriverPrivilege", True
Set objNewPort = objWMIService.Get _
    ("Win32_TCPIPPrinterPort").SpawnInstance_
objNewPort.Name = "IP_111.222.111.11"
objNewPort.Protocol = 1
objNewPort.HostAddress = "111.222.111.11"
objNewPort.PortNumber = "9999"
objNewPort.SNMPEnabled = False
objNewPort.Put_

Пример кода с использованием этого метода также описан в разделе SWbemPrivilegeSet .

Требования

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

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

SWbemPrivilegeSet

SWbemPrivilegeSet.Add

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

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

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

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