Méthode IMoniker ::IsEqual (objidl.h)
Détermine si ce moniker est identique au moniker spécifié.
Syntaxe
HRESULT IsEqual(
[in] IMoniker *pmkOtherMoniker
);
Paramètres
[in] pmkOtherMoniker
Pointeur vers l’interface IMoniker sur le moniker à utiliser pour la comparaison avec celui-ci (celui à partir duquel cette méthode est appelée).
Valeur retournée
Cette méthode retourne S_OK pour indiquer que les deux monikers sont identiques, et S_FALSE autrement.
Remarques
Les implémentations précédentes de la table d’objets en cours d’exécution (ROT) appelaient cette méthode. L’implémentation actuelle du ROT utilise l’interface IROTData à la place.
Remarques aux appelants
Appelez cette méthode pour déterminer si deux monikers sont identiques. La forme réduite d’un moniker est considérée comme différente de la forme non réduite. Vous devez appeler la méthode IMoniker ::Reduce avant d’appeler IsEqual, car un moniker réduit est dans sa forme la plus spécifique. IsEqual peut retourner S_FALSE sur deux monikers avant qu’ils ne soient réduits, et S_OK après leur réduction.Remarques aux implémenteurs
Votre implémentation ne doit pas réduire le moniker actuel avant d’effectuer la comparaison. Il est de la responsabilité de l’appelant d’appeler IMoniker ::Reduce pour comparer les monikers réduits.Deux monikers qui se comparent comme étant égaux doivent hacher à la même valeur à l’aide de IMoniker ::Hash.
Notes spécifiques à l’implémentation
| Implémentation | Notes |
|---|---|
| Anti-moniker | Cette méthode retourne S_OK si les deux sont des anti-monikers ; sinon, elle retourne S_FALSE. |
| Moniker de classe | Cette méthode retourne S_OK si pmkOther est un moniker de classe construit avec les mêmes informations CLSID que lui-même. Sinon, la méthode retourne S_FALSE. Peut retourner E_INVALIDARG si pmkOther est un pointeur non valide. |
| Moniker de fichier | Cette méthode retourne S_OK si *pmkOther est un moniker de fichier et que les chemins des deux monikers sont identiques (à l’aide d’une comparaison qui ne respecte pas la casse). Sinon, la méthode retourne S_FALSE. |
| Moniker composite générique | Cette méthode retourne S_OK si les composants des deux monikers sont égaux lorsqu’ils sont comparés dans l’ordre de gauche à droite. |
| Moniker d’élément | Cette méthode retourne S_OK si les deux monikers sont des monikers d’élément et que leurs noms d’affichage sont identiques (à l’aide d’une comparaison ne respectant pas la casse) ; sinon, la méthode retourne S_FALSE. |
| MONIKER OBJREF | Cette méthode retourne S_OK si *pmkOther est un moniker OBJREF et que les chemins des deux monikers sont identiques (à l’aide d’une comparaison qui ne respecte pas la casse). Sinon, la méthode retourne S_FALSE. |
| Moniker de pointeur | Cette méthode retourne S_OK uniquement si les deux sont des monikers de pointeur et que les pointeurs d’interface qu’ils encapsulent sont identiques. |
| Moniker d’URL | Retourne S_FALSE si l’autre moniker (pmkOtherMoniker) n’est pas un moniker d’URL, qu’il vérifie à l’aide de IPersist ::GetClassID pour voir si le CLSID est CLSID_URLMoniker. Si l’autre moniker est un moniker d’URL, il compare les noms d’affichage des monikers à des fins d’égalité, en retournant S_OK s’ils sont identiques ou S_FALSE sinon. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | objidl.h |