Método SWbemPropertySet.Remove
El método Remove del objeto SWbemPropertySet elimina una propiedad de la colección SWbemPropertySet.
A fin de obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.
Sintaxis
SWbemPropertySet.Remove( _
ByVal strName, _
[ ByVal iFlags ] _
)
Parámetros
-
strName [in]
-
Necesario. Nombre del elemento que se va a quitar.
-
iFlags [in, optional]
-
Reservado. Si se especifica, este valor debe ser 0 (cero).
Valor devuelto
Este método no devuelve ningún valor.
Códigos de error
Después de completar el método Remove, el objeto Err puede contener uno de los códigos de error de la siguiente lista.
-
wbemErrFailed: 2147749889 (0x80041001)
-
Error no especificado.
-
wbemErrInvalidOperation: 2147749910 (0x80041016)
-
El usuario intentó eliminar una propiedad que no se puede eliminar.
-
wbemErrInvalidParameter: 2147749896 (0x80041008)
-
Se ha especificado un parámetro no válido.
-
wbemErrNotFound: 2147749890 (0x80041002)
-
La propiedad especificada no existe.
-
wbemErrOutOfMemory: 2147749894 (0x80041006)
-
No hay suficiente memoria para que este método se ejecute.
-
wbemErrPropagatedProperty - 142927303552 (0x2147219380)
-
El usuario intentó eliminar una propiedad sin propietario. Se trataba de una propiedad heredada de una clase principal.
-
wbemErrResetToDefault: 2147758082 (0x80043002)
-
El usuario eliminó la invalidación de un valor predeterminado de la clase actual. Por tanto, se ha reactivado el valor predeterminado de esta propiedad que se define en la clase primaria.
Comentarios
Las propiedades no se pueden quitar de las instancias de clase ni de las clases derivadas con propiedades heredadas. Estos intentos de eliminación generan un error y la propiedad no se quita; la propiedad se restablece a su valor predeterminado.
No se puede iterar una colección mientras se quitan elementos porque, cuando se quita un elemento de una colección, el puntero de la colección se mueve al elemento siguiente. Para más información, consulte Acceso a una colección.
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 |