Método SWbemPropertySet.Add
El método Add del objeto SWbemPropertySet agrega un objeto SWbemProperty a la colección SWbemPropertySet. Si ya existe en la colección una propiedad con el mismo nombre, su contenido se reemplaza por la nueva definición.
Nota
El valor de la propiedad agregada es NULL (sin asignar) después de esta operación. Para establecer o cambiar el valor de una propiedad WMI, debe establecer la propiedad Value del objeto SWbemProperty devuelto.
Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.
Sintaxis
objProperty = .Add( _
ByVal strName, _
ByVal iCIMType, _
[ ByVal bIsArray ], _
[ ByVal iFlags ] _
)
Parámetros
-
strName [in]
-
Necesario. Nombre de la propiedad nueva.
-
iCIMType [in]
-
Necesario. Entero que representa el calificador CIMType de la nueva propiedad. Vea WbemCimTypeEnum para obtener la lista de los calificadores CIMType y sus valores.
-
bIsArray [in, optional]
-
Especifica si la propiedad es un tipo de matriz. El valor predeterminado de este parámetro es FALSE.
-
iFlags [in, optional]
-
Está reservado y debe ser cero si se especifica.
Valor devuelto
Si se ejecuta correctamente, este método devuelve un objeto SWbemProperty que representa la nueva propiedad. De lo contrario, se devuelve un objeto NULL.
Códigos de error
Tras la finalización del método Add, el objeto Err puede contener uno de los códigos de error siguientes.
-
wbemErrFailed: 2147749889 (0x80041001)
-
Error no especificado.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Se ha especificado un parámetro no válido.
-
wbemErrOutOfMemory: 2147749894 (0x80041006)
-
No hay suficiente memoria para que este método se ejecute.
-
wbemErrInvalidPropertyType: 2147749930
-
No se reconoce el calificador CIMType.
Ejemplos
Para obtener un ejemplo de código que use este método, vea el tema SWbemPropertySet.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemPropertySet |
| IID |
IID_ISWbemPropertySet |