IResultDataCompare::Compare-Methode (mmc.h)

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

Die IResultDataCompare::Compare-Methode kann nicht für Bereichselemente verwendet werden. Diese Funktionalität wird jedoch von der IResultDataCompareEx::Compare-Methode bereitgestellt.

Syntax

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

Parameter

[in] lUserParam

Ein Wert, der vom Benutzer bereitgestellte Informationen angibt, die an IResultData::Sort übergeben werden. MMC interpretiert diesen Parameter nicht.

[in] cookieA

Der eindeutige Bezeichner des ersten Ergebniselementobjekts, das im Rahmen des Sortiervorgangs verglichen werden soll.

[in] cookieB

Der eindeutige Bezeichner des zweiten Ergebniselementobjekts, das im Rahmen des Sortiervorgangs verglichen werden soll.

[in, out] pnResult

Als in-Parameter enthält das Argument die spalte, die sortiert ist. Als out-Parameter sollte der Wert des Arguments wie folgt sein:

  • -1, wenn Element 1 < Element 2
  • null (0), wenn Element 1 == Element 2
  • 1, 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 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.

Diese IResultDataCompare-Schnittstelle wird nicht für die Sortierung virtueller Listen aufgerufen. Da das Snap-In den gesamten Elementdatenspeicher für eine virtuelle Liste beibehält, muss das Snap-In die Elemente selbst sortieren. Ein Snap-In muss die IResultOwnerData-Schnittstelle implementieren, um die Sortierung für virtuelle Listen bereitzustellen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h

Weitere Informationen

IResultData::Sortierung

IResultOwnerData::SortItems