Compartir a través de

Función CompareTo

  • Artículo

Compara un objeto de administración de Windows con otro.

Nota

Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.

Sintaxis

HRESULT CompareTo (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              flags,
   [in] IWbemClassObject* pCompareTo
);

Parámetros

vFunc
[in] Este parámetro no se usa.

ptr
[in] El valor de este parámetro se corresponde con un puntero que apunta a una instancia de la interfaz IWbemClassObject.

flags
[in] El valor de este parámetro se corresponde con una combinación bit a bit de las marcas con las que se especifican las características del objeto que se deben tenerse en cuenta durante el proceso de comparación. Consulte la sección Comentarios para obtener más información.

pCompareTo
[in] El valor de este parámetro se corresponde con el objeto que se va a usar en el proceso de comparación. El valor del parámetro pCompareTo debe hacer referencia a una instancia válida de la interfaz IWbemClassObject; no puede establecerse en null.

Valor devuelto

Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:

Constante Value Descripción
WBEM_E_FAILED 0x80041001 Error no especificado.
WBEM_E_INVALID_PARAMETER 0x80041008 Si se devuelve este valor, significará que el parámetro en cuestión no es válido.
WBEM_E_UNEXPECTED 0x8004101d Si se devuelve este valor, significará que se realizó una segunda llamada a la función BeginEnumeration sin que se realizase una llamada de intervención a la función EndEnumeration.
WBEM_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.
WBEM_S_DIFFERENT 0x40003 Si se devuelve este valor, significará que los objetos son diferentes.
WBEM_S_SAME 0 Si se devuelve este valor, significará que los objetos son los mismos en cuanto a las marcas que se han usado en el proceso de comparación.

Comentarios

Al usar esta función, se ajusta una llamada al método IWbemClassObject::CompareTo.

Las marcas que se pueden pasar en el argumento lEnumFlags se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlas como constantes en el código. Para especificar las características individuales que quiere implicar en el proceso de comparación, puede especificar una combinación bit a bit de las siguientes marcas:

Constante Value Descripción
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Si se usa este valor, se omitirá el origen (el servidor y el espacio de nombres del que proceden los objetos).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Si se usa este valor, se omitirán todos los calificadores (entre los que se incluyen Key y Dynamic).
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Si se usa este valor, se omitirán los valores predeterminados de las propiedades. Esta marca solo se aplica a los procesos de comparación de clases.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Si se usa este valor, se omitirán los tipos de calificador. Al usar este marcador, los calificadores seguirán teniéndose en cuenta, pero se omitirán las distinciones de modos como, por ejemplo, las reglas de propagación y las restricciones de reemplazamiento.
WBEM_FLAG_IGNORE_CASE 0x10 Si se usa este valor, se omitirán las mayúsculas y minúsculas cuando se comparen los valores de cadenas. Esto se aplica tanto a cadenas como a valores de calificadores. Los procesos de comparación de nombres de propiedad y de calificadores siempre distingue mayúsculas de minúsculas, independientemente de si se establece esta marca.
WBEM_FLAG_IGNORE_CLASS 0x8 Si se usa este valor, se supondrá que los objetos que se van a comparar 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 rendimiento. Si los objetos no son de la misma clase, los resultados no se definen.

De manera alternativa, puede especificar una sola marca compuesta de la siguiente manera:

Constante Value Descripción
WBEM_COMPARISON_INCLUDE_ALL 0 Si se usa este valor, se tendrán en cuenta todas las características durante el proceso de comparación.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: está disponible desde la versión 4.7.2

Consulte también