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 |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemPrivilegeSet |
| IID |
IID_ISWbemPrivilegeSet |