Método SWbemQualifierSet.Add

Artículo
06/29/2023

El método Add del objeto SWbemQualifierSet agrega un objeto SWbemQualifier a la colección SWbemQualifierSet. Si ya existe un calificador 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

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

Parámetros

strName [in]: Necesario. Nombre del nuevo calificador.
varVal [in]: Necesario. Valor variant del nuevo calificador.
bPropagatesToSubclasses [in, opcional]: Valor booleano que indica si este nuevo calificador se propaga a subclases. El valor predeterminado es TRUE.
bPropagatesToInstances [in, opcional]: Valor booleano que indica si este nuevo calificador se propaga a instancias. El valor predeterminado es TRUE.
bOverridable [in, opcional]: Valor booleano que indica si este calificador se puede invalidar cuando se propaga. El valor predeterminado es TRUE.
iFlags [in, opcional]: Reservado. El valor predeterminado es 0.

Valor devuelto

Si se ejecuta correctamente, este método devuelve un objeto SWbemQualifier que representa el nuevo calificador. 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 uno de los códigos de error de la lista siguiente.

wbemErrInvalidParameter: 2147749896 (0x80041008): El parámetro iFlags no era válido.
wbemErrFailed: 2147749889 (0x80041001): Error no especificado.
wbemErrCannotBeKey: 2147749919 (0x8004101F): Se produjo un intento no válido de especificar un calificador de clave en una propiedad que no puede ser una clave. Las claves se especifican en la definición de la clase de un objeto, y no se pueden modificar instancia por instancia.
wbemErrInvalidQualifierType: 2147749929 (0x80041029): Si se devuelve este valor, significa que el parámetro varVal no es un tipo de calificador legal.
wbemErrOverrideNotAllowed: 2147749914 (0x8004101A): No es posible realizar la operación SWbemQualifierSet.Add en este calificador porque el objeto propietario no permite la invalidación.

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_SWbemQualifierSet
IID	IID_ISWbemQualifierSet

Consulte también

SWbemQualifierSet
SWbemQualifierSet.Remove