Método SWbemQualifierSet.Add
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 |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemQualifierSet |
| IID |
IID_ISWbemQualifierSet |