Estrutura RESULTDATAITEM (mmc.h)
A estrutura RESULTDATAITEM especifica ou recebe os atributos dos itens de resultado no painel de resultados do snap-in.
Sintaxe
typedef struct _RESULTDATAITEM {
DWORD mask;
BOOL bScopeItem;
HRESULTITEM itemID;
int nIndex;
int nCol;
LPOLESTR str;
int nImage;
UINT nState;
LPARAM lParam;
int iIndent;
} RESULTDATAITEM;
Membros
mask
Um conjunto de sinalizadores que especifica atributos dessa estrutura de dados ou uma operação que usa essa estrutura.
Os sinalizadores a seguir especificam os membros da estrutura RESULTDATAITEM que contêm dados válidos ou precisam ser preenchidos com dados. Um ou mais sinalizadores podem ser definidos.
RDI_STR (0x0002)
O membro str é válido ou deve ser preenchido.
RDI_IMAGE (0x0004)
O membro nImage é válido ou deve ser preenchido.
RDI_STATE (0x0008)
O membro nState é válido ou deve ser preenchido.
RDI_PARAM (0x0010)
O membro lParam é válido ou deve ser preenchido.
RDI_INDEX (0x0020)
O membro nIndex é válido ou deve ser preenchido.
RDI_INDENT (0x0040)
O membro iIndent é válido ou deve ser preenchido.
bScopeItem
TRUE se o membro lParam se referir a um item de escopo. FALSE se o membro lParam se referir a um item de resultado.
itemID
Um valor que especifica um identificador de item exclusivo fornecido pelo console para o item de resultado. Esse valor é usado para identificar um item no painel de resultados de chamadas para alguns
Métodos de interface IResultData .
Após o snap-in inserir com êxito um item no painel de escopo (usando IResultData::InsertItem), o membro itemID da estrutura RESULTDATAITEM contém o identificador HRESULTITEM do item recém-inserido. Esse identificador é o identificador exclusivo do item de resultado.
O snap-in deve armazenar esse valor para manipular (posteriormente) o item inserido chamando métodos como IResultData::GetItem. Se esse valor não for armazenado, ele poderá ser pesquisado usando IResultData::FindItemByLParam.
nIndex
Um valor que especifica o índice baseado em zero do item ao qual essa estrutura se refere.
nCol
Um valor que especifica a coluna na qual uma operação deve ser executada. Se a operação for executada em um item e não em uma coluna, o valor será zero (0).
str
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto do item se a estrutura especificar o atributo de item RDI_STR . Se esse membro for o valor MMC_CALLBACK , o item será um item de retorno de chamada.
Lembre-se de que o snap-in pode usar MMC_TEXTCALLBACK em vez de MMC_CALLBACK. O valor MMC_TEXTCALLBACK é uma versão correta do tipo (nenhuma conversão necessária) do MMC_CALLBACK.
MMC_TEXTCALLBACK é introduzido no MMC versão 1.2.
nImage
Índice de imagem virtual do ícone do item de exibição de lista nas listas de imagens de ícone grande e pequena. Lembre-se de que o índice de imagem virtual é mapeado internamente para o índice real. Esse membro também pode ser especificado como um item de retorno de chamada: MMC_CALLBACK ou MMC_IMAGECALLBACK. O valor MMC_IMAGECALLBACK é uma versão correta do tipo (nenhuma conversão necessária) do MMC_CALLBACK.
MMC_IMAGECALLBACK é introduzido no MMC versão 1.2.
nState
Um valor que especifica a máscara de estado do item. Pode ser um dos seguintes valores.
LVIS_CUT
O item é marcado para uma operação de recortar e colar.
LVIS_DROPHILITED
O item é realçado como um destino de arrastar e soltar.
LVIS_FOCUSED
O item tem o foco, portanto, ele é cercado por um retângulo de foco padrão. Mais de um item pode ser selecionado, mas apenas um item pode ter o foco.
LVIS_SELECTED
O item está selecionado. A aparência de um item selecionado depende se ele tem o foco e as cores do sistema usadas para a seleção.
lParam
Um valor que especifica um valor de 32 bits fornecido pelo usuário a ser associado ao item. Esse item, também chamado de cookie, é o valor que é passado como o primeiro parâmetro para IComponent::QueryDataObject.
iIndent
Reservado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | mmc.h |