IMoniker::IsEqual-Methode (objidl.h)
Bestimmt, ob dieser Moniker mit dem angegebenen Moniker identisch ist.
Syntax
HRESULT IsEqual(
[in] IMoniker *pmkOtherMoniker
);
Parameter
[in] pmkOtherMoniker
Ein Zeiger auf die IMoniker-Schnittstelle auf dem Moniker, der für den Vergleich mit diesem (von dem aus diese Methode aufgerufen wird) verwendet werden soll.
Rückgabewert
Diese Methode gibt S_OK zurück, um anzugeben, dass die beiden Moniker identisch sind, und S_FALSE andernfalls.
Hinweise
In früheren Implementierungen der ausgeführten Objekttabelle (ROT) wurde diese Methode aufgerufen. Die aktuelle Implementierung von ROT verwendet stattdessen die IROTData-Schnittstelle .
Hinweise für Anrufer
Rufen Sie diese Methode auf, um zu ermitteln, ob zwei Moniker identisch sind. Die reduzierte Form eines Monikers unterscheidet sich von der nicht reduzierten Form. Sie sollten die IMoniker::Reduce-Methode aufrufen, bevor Sie IsEqual aufrufen, da ein reduzierter Moniker in seiner spezifischsten Form ist. IsEqual kann S_FALSE auf zwei Monikern zurückgeben, bevor sie reduziert werden, und S_OK, nachdem sie reduziert wurden.Hinweise zu Implementierern
Ihre Implementierung sollte den aktuellen Moniker nicht reduzieren, bevor Sie den Vergleich durchführen. Es liegt in der Verantwortung des Anrufers , IMoniker::Reduce aufzurufen, um reduzierte Moniker zu vergleichen.Zwei Moniker, die als gleich vergleichen, müssen mit IMoniker::Hash auf denselben Wert hashen.
Implementierungsspezifische Hinweise
| Implementierung | Hinweise |
|---|---|
| Antimoniker | Diese Methode gibt S_OK zurück, wenn beide Antimoniker sind. Andernfalls wird S_FALSE zurückgegeben. |
| Klassenmoniker | Diese Methode gibt S_OK zurück, wenn pmkOther ein Klassenmoniker ist, der mit den gleichen CLSID-Informationen wie selbst erstellt wird. Andernfalls gibt die Methode S_FALSE zurück. Kann E_INVALIDARG zurückgeben, wenn pmkOther ein ungültiger Zeiger ist. |
| Dateimoniker | Diese Methode gibt S_OK zurück, wenn *pmkOther ein Dateimoniker ist und die Pfade für beide Moniker identisch sind (unter Verwendung eines Vergleichs ohne Beachtung der Groß-/Kleinschreibung). Andernfalls gibt die Methode S_FALSE zurück. |
| Generischer zusammengesetzter Moniker | Diese Methode gibt S_OK zurück, wenn die Komponenten beider Moniker gleich sind, wenn sie in der Reihenfolge von links nach rechts verglichen werden. |
| Elementmoniker | Diese Methode gibt S_OK zurück, wenn beide Moniker Elementmoniker sind und ihre Anzeigenamen identisch sind (unter Verwendung eines Vergleichs ohne Beachtung der Groß-/Kleinschreibung); Andernfalls gibt die Methode S_FALSE zurück. |
| OBJREF-Moniker | Diese Methode gibt S_OK zurück, wenn *pmkOther ein OBJREF-Moniker ist und die Pfade für beide Moniker identisch sind (unter Verwendung eines Vergleichs ohne Beachtung der Groß-/Kleinschreibung). Andernfalls gibt die Methode S_FALSE zurück. |
| Zeigermoniker | Diese Methode gibt nur S_OK zurück, wenn beide Zeigermoniker sind und die Schnittstellenzeiger, die sie umschließen, identisch sind. |
| URL-Moniker | Gibt S_FALSE zurück, wenn der andere Moniker (pmkOtherMoniker) kein URL-Moniker ist, der mithilfe von IPersist::GetClassID überprüft wird, ob die CLSID CLSID_URLMoniker ist. Wenn der andere Moniker ein URL-Moniker ist, vergleicht er die Anzeigenamen der Moniker auf Gleichheit und gibt S_OK zurück, wenn sie identisch sind oder andernfalls S_FALSE. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h |