RESULTDATAITEM-Struktur (mmc.h)
Die RESULTDATAITEM-Struktur gibt die Attribute von Ergebniselementen im Ergebnisbereich des Snap-Ins an oder empfängt diese.
Syntax
typedef struct _RESULTDATAITEM {
DWORD mask;
BOOL bScopeItem;
HRESULTITEM itemID;
int nIndex;
int nCol;
LPOLESTR str;
int nImage;
UINT nState;
LPARAM lParam;
int iIndent;
} RESULTDATAITEM;
Member
mask
Ein Satz von Flags, der Attribute dieser Datenstruktur angibt, oder einen Vorgang, der diese Struktur verwendet.
Die folgenden Flags geben die Member der RESULTDATAITEM-Struktur an, die gültige Daten enthalten oder mit Daten ausgefüllt werden müssen. Mindestens ein Flag kann festgelegt werden.
RDI_STR (0x0002)
Das str-Element ist gültig oder muss ausgefüllt werden.
RDI_IMAGE (0x0004)
Das nImage-Element ist gültig oder muss ausgefüllt werden.
RDI_STATE (0x0008)
Das nState-Element ist gültig oder muss ausgefüllt werden.
RDI_PARAM (0x0010)
Das lParam-Element ist gültig oder muss ausgefüllt werden.
RDI_INDEX (0x0020)
Das nIndex-Element ist gültig oder muss ausgefüllt werden.
RDI_INDENT (0x0040)
Das iIndent-Element ist gültig oder muss ausgefüllt werden.
bScopeItem
TRUE , wenn das lParam-Element auf ein Bereichselement verweist. FALSE , wenn der lParam-Member auf ein Ergebniselement verweist.
itemID
Ein -Wert, der einen von der Konsole bereitgestellten eindeutigen Elementbezeichner für das Ergebniselement angibt. Dieser Wert wird verwendet, um ein Element im Ergebnisbereich von Aufrufen einiger zu identifizieren.
IResultData-Schnittstellenmethoden .
Nachdem das Snap-In erfolgreich ein Element im Bereichsbereich eingefügt hat (mithilfe von IResultData::InsertItem), enthält das itemID-Element der RESULTDATAITEM-Struktur das HRESULTITEM-Handle des neu eingefügten Elements. Dieses Handle ist der eindeutige Bezeichner für das Ergebniselement.
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 Wert nicht gespeichert ist, kann er mithilfe von IResultData::FindItemByLParam gesucht werden.
nIndex
Ein -Wert, der den nullbasierten Index des Elements angibt, auf das diese Struktur verweist.
nCol
Ein -Wert, der die Spalte angibt, für die ein Vorgang ausgeführt werden soll. Wenn der Vorgang für ein Element und nicht für eine Spalte ausgeführt werden soll, ist der Wert null (0).
str
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Elementtext enthält, wenn die Struktur das RDI_STR Item-Attribut angibt. Wenn dieser Member der MMC_CALLBACK Wert ist, ist das Element ein Rückrufelement.
Beachten Sie, dass das Snap-In MMC_TEXTCALLBACK anstelle von MMC_CALLBACK verwenden kann. Der MMC_TEXTCALLBACK Wert ist eine typgerechte (keine Umwandlung erforderlich) Version von MMC_CALLBACK.
MMC_TEXTCALLBACK wird in MMC Version 1.2 eingeführt.
nImage
Virtueller Bildindex des Listenansichtselements symbol in den Bildlisten mit großen und kleinen Symbolen. Beachten Sie, dass der Index des virtuellen Bilds intern dem tatsächlichen Index zugeordnet wird. Dieses Element kann auch als Rückrufelement angegeben werden: MMC_CALLBACK oder MMC_IMAGECALLBACK. Der MMC_IMAGECALLBACK Wert ist eine typkorrekte (keine Umwandlung erforderlich) Version von MMC_CALLBACK.
MMC_IMAGECALLBACK wird in MMC Version 1.2 eingeführt.
nState
Ein -Wert, der die Zustandsmaske für das Element angibt. Dieses Argument einen der folgenden Werte annehmen.
LVIS_CUT
Das Element wird für einen Ausschneiden- und Einfügevorgang markiert.
LVIS_DROPHILITED
Das Element wird als Drag-and-Drop-Ziel hervorgehoben.
LVIS_FOCUSED
Das Element hat den Fokus, sodass es von einem Standard-Fokusrechteck umgeben ist. Es können mehrere Elemente ausgewählt werden, aber nur ein Element kann den Fokus haben.
LVIS_SELECTED
Das Element ist ausgewählt. Das Aussehen eines ausgewählten Elements hängt davon ab, ob es den Fokus hat, und von den für die Auswahl verwendeten Systemfarben.
lParam
Ein -Wert, der einen vom Benutzer bereitgestellten 32-Bit-Wert angibt, der dem Element zugeordnet werden soll. Dieses Element, auch als Cookie bezeichnet, ist der Wert, der als erster Parameter an IComponent::QueryDataObject übergeben wird.
iIndent
Reserviert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | mmc.h |