Compartir a través de


Método SWbemPrivilegeSet.Add

El método Add del objeto SWbemPrivilegeSet agrega un objeto SWbemPrivilege a la colección SWbemPrivilegeSet. Si ya existe un privilegio con el mismo nombre en la colección, se reemplaza.

Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.

Sintaxis

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

Parámetros

iPrivilege

Necesario. Una de las constantes WMI del grupo WbemPrivilegeEnum. Estas constantes son básicamente enteros que representan privilegios específicos. Por ejemplo, para agregar el privilegio que le permite apagar un sistema informático, use la constante wbemPrivilegeShutdown. En un script, debe usar el equivalente numérico de 23 (0x17). Para obtener una lista completa de estas constantes y las cadenas de privilegios asociadas, vea Constantes de privilegios.

bIsEnabled [opcional]

Valor booleano que habilita o deshabilita este privilegio. El valor predeterminado es TRUE.

Valor devuelto

Si se ejecuta correctamente, el método devuelve un objeto SWbemPrivilege que representa el privilegio nuevo. De lo contrario, se devuelve un objeto null.

Códigos de error

Después de completar el método Add, el objeto Err puede contener el código de error de esta lista.

wbemErrFailed: 2147749889 (0x80041001)

Error no especificado.

Ejemplos

En el tema SWbemPrivilegeSet se describe un ejemplo de código con este método.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Encabezado
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
Archivo DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPrivilegeSet
IID
IID_ISWbemPrivilegeSet

Consulte también

SWbemPrivilegeSet

Ejecución de operaciones con privilegios

Ejecución de operaciones con privilegios mediante VBScript

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Constantes de privilegios