Méthode IResultDataCompare::Compare (mmc.h)

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

La méthode IResultDataCompare::Compare ne peut pas être utilisée pour les éléments d’étendue. Toutefois, cette fonctionnalité est fournie par la méthode IResultDataCompareEx::Compare .

Syntaxe

HRESULT Compare(
  [in]      LPARAM     lUserParam,
  [in]      MMC_COOKIE cookieA,
  [in]      MMC_COOKIE cookieB,
  [in, out] int        *pnResult
);

Paramètres

[in] lUserParam

Valeur qui spécifie les informations fournies par l’utilisateur qui sont passées dans IResultData::Sort. MMC n’interprète pas ce paramètre.

[in] cookieA

Identificateur unique du premier objet élément de résultat à comparer dans le cadre de l’opération de tri.

[in] cookieB

Identificateur unique du deuxième objet élément de résultat à comparer dans le cadre de l’opération de tri.

[in, out] pnResult

En tant que paramètre in, l’argument contient la colonne triée. En tant que paramètre out, la valeur de l’argument doit être :

• -1 si l’élément 1 < élément 2
• zéro (0) si l’élément 1 == élément 2
• 1 si é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’élément de résultat qui apparaissent dans le volet des résultats. Le tri intégré fourni par MMC utilise uniquement la fonction de comparaison de chaînes de la bibliothèque d’exécution 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 de résultats standard, la console complète les résultats de comparaison, ce qui entraîne un ordre de tri décroissant.

Cette interface IResultDataCompare n’est pas appelée pour le tri de liste virtuelle. Étant donné que le composant logiciel enfichable gère tout le stockage des données d’élément d’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 assurer le tri des listes virtuelles.

Spécifications

Voir aussi

IResultData::Sort

IResultOwnerData::SortItems