IResultDataCompareEx::Compare-Methode (mmc.h)

Die IResultDataCompareEx::Compare-Methode bietet eine Möglichkeit für ein primäres Snap-In, Elemente zum Sortieren des Bereichs und der Ergebniselemente zu vergleichen, die in den Ergebnisbereich eingefügt werden.

Syntax

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

Parameter

[in] prdc

Ein Zeiger auf eine RDCOMPARE-Struktur , die Informationen zu den zu vergleichenden Elementen enthält und welche Spalte in der Listenansicht des Ergebnisbereichs sortiert wird.

[out] pnResult

Das Snap-In sollte pnResult auf das Ergebnis des Vergleichs festlegen:

• Jede negative ganze Zahl, wenn Element 1 < Element 2
• Null (0), wenn Element 1 == Element 2
• Jede positive ganze Zahl, wenn Element 1 > Element 2

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Compare bietet einen Mechanismus zum Bestimmen der Sortierreihenfolge von Bereichs- und Ergebniselementobjekten, die im Ergebnisbereich angezeigt werden. Die von MMC bereitgestellte integrierte Sortierung verwendet nur die Zeichenfolgenvergleichsfunktion der C-Laufzeitbibliothek, um die Daten zu vergleichen. Wenn diese Schnittstelle implementiert ist, wird sie für alle Vergleiche verwendet.

Der Vergleich sollte auf einer aufsteigenden Sortierreihenfolge basieren. Wenn der Benutzer den Header der Standardergebnisansicht umschaltet, ergänzt die Konsole die Vergleichsergebnisse, was zu einer absteigenden Sortierreihenfolge führt.

Die IResultDataCompareEx-Schnittstelle wird für die Sortierung virtueller Listen nicht aufgerufen. Dies liegt daran, dass das Snap-In den gesamten Elementdatenspeicher für eine virtuelle Liste beibehält. Das Snap-In muss die Elemente selbst sortieren. Ein Snap-In muss die IResultOwnerData-Schnittstelle implementieren, um die Sortierung für virtuelle Listen bereitzustellen.

Anforderungen