Método SWbemPrivilegeSet.AddAsString

Artículo
07/03/2023

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	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
Archivo DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPrivilegeSet
IID	IID_ISWbemPrivilegeSet

Consulte también

SWbemPrivilegeSet
SWbemPrivilegeSet.Add
SWbemPrivilegeSet.Remove
WbemPrivilegeEnum
Constantes de privilegios
Ejecución de operaciones con privilegios
Ejecución de operaciones con privilegios mediante VBScript