SWbemPrivilegeSet.Add method

The Add method of the SWbemPrivilegeSet object adds an SWbemPrivilege object to the SWbemPrivilegeSet collection. If a privilege with the same name already exists in the collection, it is replaced.

For an explanation of this syntax, see Document Conventions for the Scripting API.

Syntax

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

Parameters

iPrivilege

Required. One of the WMI constants from the WbemPrivilegeEnum group. These constants are essentially integers that represent specific privileges. For example, to add the privilege that allows you to shut down a computer system, use the wbemPrivilegeShutdown constant. In a script, you must use the numeric equivalent of 23 (0x17). For a complete list of these constants and the associated privilege strings, see Privilege Constants.

bIsEnabled [optional]

Boolean value that enables or disables this privilege. The default value is TRUE.

Return value

If successful, the method returns an SWbemPrivilege object that represents the new privilege. Otherwise, a null object is returned.

Error codes

Upon the completion of the Add method, the Err object may contain the error code in the following list.

wbemErrFailed - 2147749889 (0x80041001)

Unspecified error.

Examples

A code example using this method is described in the SWbemPrivilegeSet topic.

Requirements

See also

SWbemPrivilegeSet

Executing Privileged Operations

Executing Privileged Operations Using VBScript

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Privilege Constants