Método SWbemObject.CompareTo_

El método CompareTo_ del objeto SWbemObject compara dos objetos SWbemObject. Esta comparación está sujeta a ciertas restricciones en función de los valores especificados en el parámetro iFlags.

Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.

Sintaxis

bAreEqual = .CompareTo_( _
  ByVal objwbemObject, _
  [ ByVal iFlags ] _
)

Parámetros

objwbemObject [entrada]

Necesario. Este parámetro es un objeto SWbemObject. Este es el objeto con el que se compara el primero. El objeto debe ser una instancia válida de SWbemObject.

iFlags [entrada, opcional]

Especifica las características de objeto que se deben tener en cuenta al comparar un objeto con otros. Puede usar wbemComparisonFlagIncludeAll para tener en cuenta todas las características (este es el valor predeterminado) o cualquier combinación de los valores siguientes.

wbemComparisonFlagIncludeAll (0 (0x0))

Compara todas las propiedades, calificadores y tipos.

wbemComparisonFlagIgnoreObjectSource (2 (0x2))

Hace que se omita el origen de los objetos, concretamente el servidor y espacio de nombres de donde provienen, en comparación con otros objetos.

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

Hace que todos los calificadores (incluidos Key y Dynamic) se omitan en la comparación.

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

Hace que se omitan los valores predeterminados de las propiedades. Esta marca solo es significativa cuando se comparan clases.

wbemComparisonFlagIgnoreFlavor (32 (0x20))

Hace que se omitan los tipos de calificador. Este marcador tiene en cuenta los valores del calificador, pero omite las distinciones de modos como las reglas de propagación y las restricciones de reemplazamiento.

wbemComparisonFlagIgnoreCase (16 (0x10))

Compara los valores de cadenas sin distinguir entre mayúsculas y minúsculas. Esto se aplica a cadenas y a valores del calificador. Los nombres de propiedades y calificadores siempre se comparan sin distinguir entre mayúsculas y minúsculas, se especifique o no este marcador.

wbemComparisonFlagIgnoreClass (8 (0x8))

Indica al sistema que asuma que los objetos que se comparan son instancias de la misma clase. Por tanto, al usar esta marca, solo se comparará la información que esté relacionada con instancias. Utilice este marcador para optimizar el desarrollo. Si los objetos no son de la misma clase, los resultados no se definen.

Valor devuelto

Este método devuelve el valor booleano de TRUE si los objetos coinciden. Devuelve FALSE si los objetos no coinciden.

Códigos de error

Después de completar el método CompareTo_, el objeto Err puede contener uno de los códigos de error de esta lista.

wbemErrFailed: 2147749889 (0x80041001)

Error no especificado.

wbemErrInvalidParameter: 2147749896 (0x80041008)

Un parámetro especificado no es válido.

wbemErrOutOfMemory: 2147749894 (0x80041006)

No hay suficiente memoria para completar la operació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_SWbemObject
IID	IID_ISWbemObject

Consulte también

SWbemObject