IResultDataCompareEx::Compare, méthode (mmc.h)

La méthode IResultDataCompareEx::Compare permet à un composant logiciel enfichable principal de comparer des éléments dans le but de trier les éléments d’étendue et de résultat qu’il insère dans le volet de résultats.

Syntaxe

HRESULT Compare(
  [in]  RDCOMPARE *prdc,
  [out] int       *pnResult
);

Paramètres

[in] prdc

Pointeur vers une structure RDCOMPARE qui contient des informations sur les éléments comparés et sur la colonne de l’affichage de liste du volet de résultats qui est triée.

[out] pnResult

Le composant logiciel enfichable doit définir pnResult sur le résultat de la comparaison :

• Tout entier négatif si l’élément 1 < élément 2
• Zéro (0) si l’élément 1 == élément 2
• Tout entier positif si l’élément 1 > élément 2

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Compare fournit un mécanisme permettant de déterminer l’ordre de tri des objets d’étendue et d’élément de résultat qui apparaissent dans le volet de résultats. Le tri intégré fourni par MMC utilise uniquement la fonction de comparaison de chaînes de la bibliothèque runtime C pour comparer les données. Si cette interface est implémentée, elle est utilisée pour toutes les comparaisons.

La comparaison doit être basée sur un ordre de tri croissant. Si l’utilisateur bascule l’en-tête d’affichage des résultats standard, la console complète les résultats de comparaison, ce qui entraîne un ordre de tri décroissant.

L’interface IResultDataCompareEx n’est pas appelée pour le tri de liste virtuelle. En effet, le composant logiciel enfichable conserve tout le stockage des données d’élément pour une liste virtuelle. Le composant logiciel enfichable doit trier les éléments lui-même. Un composant logiciel enfichable doit implémenter l’interface IResultOwnerData pour fournir le tri des listes virtuelles.

Spécifications