CompareTo függvény

Összehasonlít egy objektumot egy másik Windows felügyeleti objektummal.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

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

Paraméterek

vFunc
[in] Ez a paraméter nincs használatban.

ptr
[in] Egy IWbemClassObject-példányra mutató mutató.

flags
[in] Az összehasonlításhoz figyelembe veendő objektumjellemzőket meghatározó jelzők bitenkénti kombinációja. További információért tekintse meg a Megjegyzések szakaszt.

pCompareTo
[in] Az összehasonlításhoz használt objektum. pCompareTo érvényes IWbemClassObject-példánynak kell lennie; Nem lehet null.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_FAILED	0x80041001	Meghatározatlan hiba történt.
WBEM_E_INVALID_PARAMETER	0x80041008	Egy paraméter érvénytelen.
WBEM_E_UNEXPECTED	0x8004101d	A második hívása a BeginEnumeration következő beavatkozás nélküli hívása volt: EndEnumeration.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.
WBEM_S_DIFFERENT	0x40003	Az objektumok eltérőek.
WBEM_S_SAME	0	Az objektumok az összehasonlító jelzők alapján azonosak.

Megjegyzések

Ez a függvény burkolja az IWbemClassObject::CompareTo metódus hívását.

Az argumentumként lEnumFlags átadható jelzők a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban. Az összehasonlításban érintett egyedi jellemzőket az alábbi jelzők bitenkénti kombinációjának megadásával adhatja meg:

Állandó	Érték	Leírás
WBEM_FLAG_IGNORE_OBJECT_SOURCE	2	Hagyja figyelmen kívül a forrást (a kiszolgálót és a névteret, amelyből származnak).
WBEM_FLAG_IGNORE_QUALIFIERS	1	Az összes minősítő figyelmen kívül hagyása (beleértve a kulcsot és a dinamikust is)
WBEM_FLAG_IGNORE_DEFAULT_VALUES	4	A tulajdonságok alapértelmezett értékeinek figyelmen kívül hagyása. Ez a jelző csak az osztályok összehasonlítására vonatkozik.
WBEM_FLAG_IGNORE_FLAVOR	0x20	A minősítő ízek figyelmen kívül hagyása. Ez a jelző továbbra is figyelembe veszi a minősítőket, de figyelmen kívül hagyja az ízbeli különbségeket, például a propagálási szabályokat és a felülbírálási korlátozásokat.
WBEM_FLAG_IGNORE_CASE	0x10	A sztringértékek összehasonlításában hagyja figyelmen kívül a kis- és nagybetűket. Ez a sztringekre és a minősítő értékekre is vonatkozik. A tulajdonság- és minősítőnevek összehasonlítása mindig megkülönbözteti a kis- és nagybetűket, függetlenül attól, hogy ez a jelző be van-e állítva.
WBEM_FLAG_IGNORE_CLASS	0x8	Tegyük fel, hogy az összehasonlítandó objektumok ugyanazon osztály példányai. Következésképpen ez a jelző csak a példányokkal kapcsolatos információkat hasonlítja össze. Ezekkel a jelzőkkel optimalizálhatja a teljesítményt. Ha az objektumok nem azonos osztályba tartoznak, az eredmények nem lesznek meghatározva.

Vagy megadhat egyetlen összetett jelzőt az alábbiak szerint:

Állandó	Érték	Leírás
WBEM_COMPARISON_INCLUDE_ALL	0	Vegye figyelembe az összehasonlítás összes funkcióját.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2 óta érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)