IResultData-Schnittstelle (mmc.h)

Über die IResultData-Schnittstelle kann ein Benutzer Elemente hinzufügen, entfernen, suchen und ändern, die dem Ergebnisansichtsbereich zugeordnet sind. Es ermöglicht auch die Bearbeitung des Ansichtsstils des Ergebnisansichtsbereichs.

Die IResultData-Schnittstelle wurde entwickelt, um den Eindruck zu erwecken, dass der Ergebnisansichtsbereich nur von einer Komponente verwendet wird, aber Komponenten sollten sich bewusst sein, dass der Ergebnisansichtsbereich tatsächlich von mehreren Komponenten gemeinsam genutzt werden kann. Alle Elementbearbeitungen werden durch die Verwendung einer Element-ID ausgeführt, die beim Einfügen des Elements zugewiesen wird. Diese ID ist für die Lebensdauer des Elements garantiert statisch und eindeutig. Wenn ein Element gelöscht wird, wird die ID freigegeben und kann von anderen neuen Elementen in der Liste verwendet werden. Sie sollten eine Element-ID nie beibehalten, nachdem das zugeordnete Element gelöscht wurde.

Die IResultData-Schnittstelle verarbeitet auch virtuelle Listen (Besitzerdaten). Aufgrund der Art virtueller Listen gelten nicht alle Methoden, und einige Methoden verfügen über eingeschränkte Funktionalität. Diese Unterschiede werden in den Beschreibungen der einzelnen Methoden detailliert beschrieben. Der Hauptunterschied bei der Behandlung virtueller Elemente ist, dass die Konsole keine Speicher-IDs für virtuelle Elemente bereitstellt. Stattdessen werden virtuelle Listenelemente durch ihre Listenposition (Index) identifiziert.

Vererbung

Die IResultData-Schnittstelle erbt von der IUnknown-Schnittstelle . IResultData verfügt auch über folgende Membertypen:

Methoden

Die IResultData-Schnittstelle verfügt über diese Methoden.

 
IResultData::D eleteAllRsltItems

Mit der IResultData::D eleteAllRsltItems-Methode kann das Snap-In alle vom Benutzer eingefügten Elemente und Unterelemente aus dem Ergebnisansichtsbereich entfernen.
IResultData::D eleteItem

Ermöglicht dem Snap-In das Löschen eines einzelnen Elements im Ergebnisansichtsbereich.
IResultData::FindItemByLParam

Die IResultData::FindItemByLParam-Methode ermöglicht es dem Snap-In, ein Element oder Unterelement basierend auf seinem vom Benutzer eingefügten lParam-Wert zu suchen.
IResultData::GetItem

Ermöglicht es einem Benutzer, die Parameter eines einzelnen Elements abzurufen.
IResultData::GetNextItem

Die IResultData::GetNextItem-Methode ruft das nächste Element in der Ergebnisansicht ab, wobei die angegebenen Statusflags festgelegt sind.
IResultData::GetViewMode

Ermöglicht dem Snap-In, einen Ansichtsmodus für den Ergebnisansichtsbereich abzurufen.
IResultData::InsertItem

Mit der IResultData::InsertItem-Methode kann das Snap-In der Ergebnisbereichansicht ein einzelnes neues Element hinzufügen.
IResultData::ModifyItemState

Ermöglicht dem Snap-In, den Status eines Elements zu ändern.
IResultData::ModifyViewStyle

Mit der IResultData::ModifyViewStyle-Methode kann das Snap-In den Ansichtsstil des Ergebnisbereichs festlegen.
IResultData::SetDescBarText

Legt den Text der Beschreibungsleiste für den Ergebnisansichtsbereich fest.
IResultData::SetItem

Mit der IResultData::SetItem-Methode kann das Snap-In ein einzelnes Element im Ergebnisbereich festlegen.
IResultData::SetItemCount

Legt die Anzahl der Elemente in einer virtuellen Liste fest.
IResultData::SetViewMode

Ermöglicht dem Snap-In das Festlegen des Ansichtsmodus, in dem der Ergebnisansichtsbereich seine Elemente anzeigt.
IResultData::Sortierung

Sortiert alle Elemente im Ergebnisbereich.
IResultData::UpdateItem

Bewirkt, dass ein angegebenes Element im Ergebnisbereich neu gezeichnet wird.

Anforderungen

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