IResultData::InsertItem-Methode (mmc.h)

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

Syntax

HRESULT InsertItem(
  [in, out] LPRESULTDATAITEM item
);

Parameter

[in, out] item

Ein Zeiger auf eine RESULTDATAITEM-Struktur , die Informationen zum hinzuzufügenden Element enthält.

Nachdem das Element eingefügt wurde, wird ihm von MMC ein eindeutiger Bezeichner (eine Element-ID) zugewiesen und über das elementID-Element der Struktur zurückgegeben, auf die der Elementparameter verweist. Beachten Sie, dass der itemID-Wert das HRESULTITEM-Handle des eingefügten Elements ist. Das Snap-In sollte diesen Wert speichern, um das eingefügte Element später durch Aufrufen von Methoden wie IResultData::GetItem zu bearbeiten.

Wenn dieser Bezeichner nicht gespeichert ist, kann er mithilfe von IResultData::FindItemByLParam gesucht werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Die Maske und alle entsprechenden zugeordneten Felder in der RESULTDATAITEM-Struktur sollten ausgefüllt werden. Unterelemente können nicht eingefügt, aber festgelegt werden. Das nCol-Element der Elementstruktur muss daher null sein.

Das str-Element von RESULTDATAITEM muss auf MMC_CALLBACK festgelegt werden.

Nachdem das Element eingefügt wurde, wird ihm von MMC ein eindeutiger Bezeichner (eine Element-ID) zugewiesen und über das elementID-Element der Struktur zurückgegeben, auf die der Elementparameter verweist. Beachten Sie, dass der itemID-Wert das HRESULTITEM-Handle des eingefügten Elements ist. Das Snap-In sollte diesen Wert speichern, um das eingefügte Element später durch Aufrufen von Methoden wie IResultData::GetItem zu bearbeiten.

Wenn dieser Bezeichner nicht gespeichert ist, kann er mithilfe von IResultData::FindItemByLParam identifiziert werden.

Diese Methode unterstützt keine virtuellen Listen.

Anforderungen

Weitere Informationen

Iresultdata

IResultData2