Vergelijken Met, functie

Vergelijkt een object met een ander Windows-beheerobject.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit code voor ontwikkelaars.

Syntaxis

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

Parameters

vFunc
[in] Deze parameter is niet gebruikt.

ptr
[in] Een verwijzing naar een IWbemClassObject-exemplaar .

flags
[in] Een bitsgewijze combinatie van de vlaggen waarmee de objectkenmerken worden opgegeven waarmee rekening moet worden gehouden voor de vergelijking. Zie de sectie Opmerkingen voor meer informatie.

pCompareTo
[in] Het object voor vergelijking. pCompareTo moet een geldig IWbemClassObject-exemplaar zijn; dit kan niet zijn null.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h , of u kunt ze definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_FAILED	0x80041001	Er is een niet-opgegeven fout opgetreden.
WBEM_E_INVALID_PARAMETER	0x80041008	Een parameter is ongeldig.
WBEM_E_UNEXPECTED	0x8004101d	Er is een tweede aanroep naar BeginEnumeration gedaan zonder een tussenliggende aanroep van EndEnumeration.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.
WBEM_S_DIFFERENT	0x40003	De objecten zijn verschillend.
WBEM_S_SAME	0	De objecten zijn hetzelfde op basis van de vergelijkingsvlagmen.

Opmerkingen

Met deze functie wordt een aanroep van de methode IWbemClassObject::CompareTo verpakt.

De vlaggen die als argument lEnumFlags kunnen worden doorgegeven, worden gedefinieerd in het headerbestand WbemCli.h . U kunt ze ook definiëren als constanten in uw code. U kunt de afzonderlijke kenmerken opgeven die betrokken zijn bij de vergelijking door een bitsgewijze combinatie van de volgende vlaggen op te geven:

Constant	Waarde	Beschrijving
WBEM_FLAG_IGNORE_OBJECT_SOURCE	2	Negeer de bron (de server en de naamruimte waaruit ze afkomstig zijn).
WBEM_FLAG_IGNORE_QUALIFIERS	1	Alle kwalificaties negeren (inclusief sleutel en dynamisch)
WBEM_FLAG_IGNORE_DEFAULT_VALUES	4	Standaardwaarden van eigenschappen negeren. Deze vlag is alleen van toepassing op het vergelijken van klassen.
WBEM_FLAG_IGNORE_FLAVOR	0x20	Kwalificatiearoma's negeren. Deze vlag houdt nog steeds rekening met kwalificaties, maar negeert smaakscheidingen, zoals doorgifteregels en onderdrukkingsbeperkingen.
WBEM_FLAG_IGNORE_CASE	0x10	Hoofdlettergebruik negeren bij het vergelijken van tekenreekswaarden. Dit geldt zowel voor tekenreeksen als voor kwalificatiewaarden. De vergelijking van eigenschaps- en kwalificatienamen is altijd hoofdlettergevoelig, ongeacht of deze vlag is ingesteld.
WBEM_FLAG_IGNORE_CLASS	0x8	Stel dat de objecten die worden vergeleken exemplaren van dezelfde klasse zijn. Daarom vergelijkt deze vlag alleen exemplaargerelateerde informatie. Gebruik deze vlaggen om de prestaties te optimaliseren. Als de objecten niet van dezelfde klasse zijn, zijn de resultaten niet gedefinieerd.

Of u kunt als volgt één samengestelde vlag opgeven:

Constant	Waarde	Beschrijving
WBEM_COMPARISON_INCLUDE_ALL	0	Houd rekening met alle functies in de vergelijking.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)