CompareTo işlevi

Bir nesneyi başka bir Windows yönetim nesnesiyle karşılaştırır.

Not

Bu API yalnızca dahili kullanım içindir. Geliştirici kodundan kullanıma yönelik değildir.

Sözdizimi

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

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

ptr
[in] IWbemClassObject örneğinin işaretçisi .

flags
[in] Karşılaştırma için dikkate alınacak nesne özelliklerini belirten bayrakların bit düzeyinde birleşimi. Daha fazla bilgi için Açıklamalar bölümüne bakın.

pCompareTo
[in] Karşılaştırma için nesnesi. pCompareTo geçerli bir IWbemClassObject örneği olmalıdır; olamaz null.

Döndürülen değer

Bu işlev tarafından döndürülen aşağıdaki değerler WbemCli.h üst bilgi dosyasında tanımlanır veya bunları kodunuzda sabit olarak tanımlayabilirsiniz:

Sabit	Değer	Açıklama
WBEM_E_FAILED	0x80041001	Belirtilmemiş bir hata oluştu.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametre geçersiz.
WBEM_E_UNEXPECTED	0x8004101d	öğesine araya girmeden ikinci BeginEnumeration bir çağrısı EndEnumerationyapıldı.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.
WBEM_S_DIFFERENT	0x40003	Nesneler farklıdır.
WBEM_S_SAME	0	Nesneler, karşılaştırma bayraklarına göre aynıdır.

Açıklamalar

Bu işlev , IWbemClassObject::CompareTo yöntemine yapılan çağrıyı sarmalar.

Bağımsız değişken olarak lEnumFlags geçirilebilen bayraklar WbemCli.h üst bilgi dosyasında tanımlanır veya bunları kodunuzda sabit olarak tanımlayabilirsiniz. Aşağıdaki bayrakların bit düzeyinde bir bileşimini belirterek karşılaştırmada yer alan tek tek özellikleri belirtebilirsiniz:

Sabit	Değer	Açıklama
WBEM_FLAG_IGNORE_OBJECT_SOURCE	2	Kaynağı (geldikleri sunucu ve ad alanını) yoksayın.
WBEM_FLAG_IGNORE_QUALIFIERS	1	Tüm niteleyicileri yoksayma ( Anahtar ve Dinamik dahil)
WBEM_FLAG_IGNORE_DEFAULT_VALUES	4	Özelliklerin varsayılan değerlerini yoksayın. Bu bayrak yalnızca sınıfların karşılaştırması için geçerlidir.
WBEM_FLAG_IGNORE_FLAVOR	0x20	Niteleyici tatlarını yoksayın. Bu bayrak yine de niteleyicileri dikkate alır, ancak yayma kuralları ve geçersiz kılma kısıtlamaları gibi aroma ayrımlarını yoksayar.
WBEM_FLAG_IGNORE_CASE	0x10	Dize değerlerini karşılaştırırken büyük/küçük harf durumunu yoksayın. Bu hem dizeler hem de niteleyici değerler için geçerlidir. Özellik ve niteleyici adlarının karşılaştırması, bu bayrağın ayarlanıp ayarlanmadığına bakılmaksızın her zaman büyük/küçük harfe duyarlıdır.
WBEM_FLAG_IGNORE_CLASS	0x8	Karşılaştırılan nesnelerin aynı sınıfın örnekleri olduğunu varsayalım. Sonuç olarak, bu bayrak yalnızca örnekle ilgili bilgileri karşılaştırır. Performansı iyileştirmek için bu bayrakları kullanın. Nesneler aynı sınıfta değilse, sonuçlar tanımsız olur.

Ya da aşağıdaki gibi tek bir bileşik bayrak belirtebilirsiniz:

Sabit	Değer	Açıklama
WBEM_COMPARISON_INCLUDE_ALL	0	Karşılaştırmadaki tüm özellikleri göz önünde bulundurun.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: WMINet_Utils.idl

.NET Framework Sürümleri: 4.7.2 sürümünden itibaren kullanılabilir

Ayrıca bkz.

• WMI ve Performans Sayaçları (Yönetilmeyen API Başvurusu)