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 |