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 |