Metode IMoniker::IsEqual (objidl.h)

Menentukan apakah moniker ini identik dengan moniker yang ditentukan.

Sintaks

HRESULT IsEqual(
  [in] IMoniker *pmkOtherMoniker
);

Parameter

[in] pmkOtherMoniker

Penunjuk ke antarmuka IMoniker pada moniker yang akan digunakan untuk perbandingan dengan yang ini (dari mana metode ini dipanggil).

Nilai kembali

Metode ini mengembalikan S_OK untuk menunjukkan bahwa kedua moniker identik, dan S_FALSE sebaliknya.

Keterangan

Implementasi sebelumnya dari tabel objek yang sedang berjalan (ROT) yang disebut metode ini. Implementasi ROT saat ini menggunakan antarmuka IROTData sebagai gantinya.

Catatan untuk Penelepon

Panggil metode ini untuk menentukan apakah dua moniker identik. Pengurangan bentuk moniker dianggap berbeda dari bentuk yang tidak tereduksi. Anda harus memanggil metode IMoniker::Reduce sebelum memanggil IsEqual, karena moniker yang berkurang berada dalam bentuk yang paling spesifik. IsEqual dapat mengembalikan S_FALSE pada dua moniker sebelum dikurangi, dan S_OK setelah dikurangi.

Catatan untuk Pelaksana

Implementasi Anda tidak boleh mengurangi moniker saat ini sebelum melakukan perbandingan. Pemanggil bertanggung jawab untuk memanggil IMoniker::Reduce untuk membandingkan pengurangan moniker.

Dua moniker yang membandingkan sebagai sama harus hash dengan nilai yang sama menggunakan IMoniker::Hash.

Catatan khusus implementasi

Implementasi	Catatan
Anti-moniker	Metode ini mengembalikan S_OK jika keduanya adalah anti-monikers; jika tidak, ia mengembalikan S_FALSE.
Moniker kelas	Metode ini mengembalikan S_OK jika pmkOther adalah moniker kelas yang dibangun dengan informasi CLSID yang sama dengan itu sendiri. Jika tidak, metode mengembalikan S_FALSE. Dapat mengembalikan E_INVALIDARG jika pmkOther adalah pointer yang tidak valid.
Moniker file	Metode ini mengembalikan S_OK jika *pmkOther adalah moniker file dan jalur untuk kedua moniker identik (menggunakan perbandingan yang tidak peka huruf besar/kecil). Jika tidak, metode mengembalikan S_FALSE.
Moniker komposit generik	Metode ini mengembalikan S_OK jika komponen kedua moniker sama jika dibandingkan dalam urutan kiri-ke-kanan.
Moniker item	Metode ini mengembalikan S_OK jika kedua moniker adalah moniker item dan nama tampilannya identik (menggunakan perbandingan yang tidak peka huruf besar/kecil); jika tidak, metode mengembalikan S_FALSE.
Moniker OBJREF	Metode ini mengembalikan S_OK jika *pmkOther adalah moniker OBJREF dan jalur untuk kedua moniker identik (menggunakan perbandingan yang tidak peka huruf besar/kecil). Jika tidak, metode mengembalikan S_FALSE.
Penunjuk moniker	Metode ini mengembalikan S_OK hanya jika keduanya adalah moniker penunjuk dan penunjuk antarmuka yang dibungkusnya identik.
Moniker URL	Mengembalikan S_FALSE jika moniker lain (pmkOtherMoniker) bukan moniker URL, yang diperiksa menggunakan IPersist::GetClassID untuk melihat apakah CLSID CLSID_URLMoniker. Jika moniker lain adalah moniker URL, moniker tersebut membandingkan nama tampilan moniker untuk kesetaraan, mengembalikan S_OK jika identik atau S_FALSE sebaliknya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	objidl.h

Lihat juga

IMoniker

IROTData