Método SWbemPrivilegeSet.AddAsString
El método AddAsString del objeto SWbemPrivilegeSet se puede usar para agregar un privilegio a una colección SWbemPrivilegeSet mediante una cadena de privilegios. Este método se usa para agregar un privilegio o para habilitar un privilegio para los objetos SWbemSecurity. Consulte Ejecución de operaciones con privilegios mediante VBScript.
A fin de obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.
Sintaxis
objPrivilege = .AddAsString( _
ByVal strPrivilege, _
[ ByVal bIsEnabled ] _
)
Parámetros
-
strPrivilege
-
Necesario. Una de las cadenas de privilegios. Para ver una lista completa de estas cadenas y las constantes de WMI asociadas, consulte Constantes de privilegios. Cada cadena de privilegios representa un privilegio concreto. Por ejemplo, para agregar el privilegio para apagar un sistema informático se use la cadena SeShutdownPrivilege.
-
bIsEnabled [opcional]
-
Valor booleano que habilita o deshabilita este privilegio. El valor predeterminado es True.
Valor devuelto
Si se ejecuta correctamente, este 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 AddAsString, el objeto Err puede contener el código de error de esta lista.
-
wbemErrFailed: 2147749889 (0x80041001)
-
Error no especificado.
Ejemplos
En el siguiente ejemplo de código de VBScript siguiente se crea un puerto para un servidor de impresión mediante Win32_TCPIPPrinterPort. Para esta operación se necesita SeLoadDriverPrivilege. Consulte Ejecución de operaciones con privilegios.
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_
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 |