IMoniker::IsEqual-Methode (objidl.h)

  • Artikel

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

Weitere Informationen

Imoniker

IROTData