Struttura RESULTDATAITEM (mmc.h)
La struttura RESULTDATAITEM specifica o riceve gli attributi degli elementi dei risultati nel riquadro dei risultati dello snap-in.
Sintassi
typedef struct _RESULTDATAITEM {
DWORD mask;
BOOL bScopeItem;
HRESULTITEM itemID;
int nIndex;
int nCol;
LPOLESTR str;
int nImage;
UINT nState;
LPARAM lParam;
int iIndent;
} RESULTDATAITEM;
Members
mask
Set di flag che specifica gli attributi di questa struttura di dati o un'operazione che usa questa struttura.
I flag seguenti specificano i membri della struttura RESULTDATAITEM che contengono dati validi o devono essere compilati con dati. È possibile impostare uno o più flag.
RDI_STR (0x0002)
Il membro str è valido o deve essere compilato.
RDI_IMAGE (0x0004)
Il membro nImage è valido o deve essere compilato.
RDI_STATE (0x0008)
Il membro nState è valido o deve essere compilato.
RDI_PARAM (0x0010)
Il membro lParam è valido o deve essere compilato.
RDI_INDEX (0x0020)
Il membro nIndex è valido o deve essere compilato.
RDI_INDENT (0x0040)
Il membro iIndent è valido o deve essere compilato.
bScopeItem
TRUE se il membro lParam fa riferimento a un elemento di ambito. FALSE se il membro lParam fa riferimento a un elemento risultato.
itemID
Valore che specifica un identificatore univoco fornito dalla console per l'elemento del risultato. Questo valore viene usato per identificare un elemento nel riquadro dei risultati delle chiamate ad alcuni
Metodi di interfaccia IResultData .
Dopo che lo snap-in inserisce correttamente un elemento nel riquadro dell'ambito (tramite IResultData::InsertItem), il membro itemID della struttura RESULTDATAITEM contiene l'handle HRESULTITEM dell'elemento appena inserito. Questo handle è l'identificatore univoco per l'elemento del risultato.
Lo snap-in deve archiviare questo valore per modificare (in un secondo momento) l'elemento inserito chiamando metodi come IResultData::GetItem. Se questo valore non è archiviato, è possibile cercarlo usando IResultData::FindItemByLParam.
nIndex
Valore che specifica l'indice in base zero dell'elemento a cui fa riferimento questa struttura.
nCol
Valore che specifica la colonna in cui deve essere eseguita un'operazione. Se l'operazione deve essere eseguita su un elemento e non su una colonna, il valore è zero (0).
str
Puntatore a una stringa con terminazione Null contenente il testo dell'elemento se la struttura specifica l'attributo dell'elemento RDI_STR . Se questo membro è il valore MMC_CALLBACK , l'elemento è un elemento di callback.
Tenere presente che lo snap-in può usare MMC_TEXTCALLBACK anziché MMC_CALLBACK. Il valore MMC_TEXTCALLBACK è una versione corretta del tipo (nessun cast necessario) di MMC_CALLBACK.
MMC_TEXTCALLBACK è stato introdotto in MMC versione 1.2.
nImage
Indice dell'immagine virtuale dell'icona dell'elemento della visualizzazione elenco negli elenchi di immagini di icone grandi e piccole. Tenere presente che l'indice dell'immagine virtuale viene mappato internamente all'indice effettivo. Questo membro può essere specificato anche come elemento di callback: MMC_CALLBACK o MMC_IMAGECALLBACK. Il valore MMC_IMAGECALLBACK è una versione corretta del tipo (nessun cast necessario) di MMC_CALLBACK.
MMC_IMAGECALLBACK è stato introdotto in MMC versione 1.2.
nState
Valore che specifica la maschera di stato per l'elemento. Può essere uno dei valori seguenti.
LVIS_CUT
L'elemento è contrassegnato per un'operazione taglia e incolla.
LVIS_DROPHILITED
L'elemento viene evidenziato come destinazione di trascinamento della selezione.
LVIS_FOCUSED
L'elemento ha lo stato attivo, quindi è circondato da un rettangolo di stato attivo standard. È possibile selezionare più di un elemento, ma solo un elemento può avere lo stato attivo.
LVIS_SELECTED
L'elemento è selezionato. L'aspetto di un elemento selezionato dipende dal fatto che abbia lo stato attivo e sui colori di sistema utilizzati per la selezione.
lParam
Valore che specifica un valore a 32 bit fornito dall'utente da associare all'elemento. Questo elemento, detto anche cookie, è il valore passato come primo parametro a IComponent::QueryDataObject.
iIndent
Riservato.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Intestazione | mmc.h |