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 |