Fungsi CompareTo

Membandingkan objek dengan objek manajemen Windows lain.

Catatan

API ini hanya untuk penggunaan internal. API ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Sintaks

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

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

flags
[in] Kombinasi bitwise dari bendera yang menentukan karakteristik objek yang perlu dipertimbangkan untuk perbandingan. Untuk informasi selengkapnya, lihat bagian Keterangan.

pCompareTo
[in] Objek untuk perbandingan. pCompareTo harus berupa instans IWbemClassObject yang valid; tidak boleh null.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Terus-menerus Nilai Deskripsi
WBEM_E_FAILED 0x80041001 Terjadi kesalahan yang tidak tentu.
WBEM_E_INVALID_PARAMETER 0x80041008 Parameter tidak valid.
WBEM_E_UNEXPECTED 0x8004101d Panggilan kedua ke BeginEnumeration dilakukan tanpa panggilan intervensi ke EndEnumeration.
WBEM_S_NO_ERROR 0 Panggilan fungsi berhasil.
WBEM_S_DIFFERENT 0x40003 Objeknya berbeda.
WBEM_S_SAME 0 Objek sama berdasarkan bendera perbandingan.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::CompareTo.

Bendera yang dapat diteruskan sebagai argumen lEnumFlags adalah yang ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda. Anda dapat menentukan karakteristik individual yang terlibat dalam perbandingan dengan menentukan kombinasi bitwise dari bendera berikut:

Terus-menerus Nilai Deskripsi
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Abaikan sumber (server dan namespace layanan asalnya).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Abaikan semua pengkualifikasi (termasuk Kunci dan Dinamis)
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Abaikan nilai default properti. Bendera ini hanya berlaku untuk perbandingan kelas.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Abaikan ragam pengkualifikasi. Bendera ini masih memperhitungkan pengkualifikasi, tetapi mengabaikan perbedaan ragam seperti aturan propagasi dan pembatasan ambil alih.
WBEM_FLAG_IGNORE_CASE 0x10 Abaikan kasus dalam membandingkan nilai string. Ini berlaku untuk string dan nilai pengkualifikasi. Perbandingan nama properti dan pengkualifikasi selalu peka huruf besar/kecil terlepas dari apakah bendera ini diatur.
WBEM_FLAG_IGNORE_CLASS 0x8 Asumsikan bahwa objek yang dibandingkan adalah instans dari kelas yang sama. Akibatnya, bendera ini hanya membandingkan informasi terkait instans. Gunakan bendera ini untuk mengoptimalkan performa. Jika objek tidak dari kelas yang sama, hasilnya tidak ditentukan.

Atau Anda dapat menentukan bendera komposit tunggal sebagai berikut:

Terus-menerus Nilai Deskripsi
WBEM_COMPARISON_INCLUDE_ALL 0 Pertimbangkan semua fitur dalam perbandingan.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

  • Last updated on