Método IResultData::InsertItem (mmc.h)
O método IResultData::InsertItem permite que o snap-in adicione um único novo item à exibição do painel de resultados.
Sintaxe
HRESULT InsertItem(
[in, out] LPRESULTDATAITEM item
);
Parâmetros
[in, out] item
Um ponteiro para uma estrutura RESULTDATAITEM que contém informações sobre o item a ser adicionado.
Depois que o item é inserido, um identificador exclusivo (uma ID de item) é atribuído a ele pelo MMC e retornado por meio do membro itemID da estrutura apontada pelo parâmetro item. Lembre-se de que o valor itemID é o identificador HRESULTITEM do item inserido. O snap-in deve armazenar esse valor para manipular posteriormente o item inserido chamando métodos como IResultData::GetItem.
Se esse identificador não estiver armazenado, ele poderá ser pesquisado usando IResultData::FindItemByLParam.
Valor retornado
Esse método pode retornar um desses valores.
Comentários
A máscara e todos os campos associados apropriados na estrutura RESULTDATAITEM devem ser preenchidos. Os subitems não podem ser inseridos, mas podem ser definidos. Portanto, o membro nCol da estrutura do item deve ser zero.
O membro str de RESULTDATAITEM deve ser definido como MMC_CALLBACK.
Depois que o item é inserido, um identificador exclusivo (uma ID de item) é atribuído a ele pelo MMC e retornado por meio do membro itemID da estrutura apontada pelo parâmetro item. Lembre-se de que o valor itemID é o identificador HRESULTITEM do item inserido. O snap-in deve armazenar esse valor para manipular posteriormente o item inserido chamando métodos como IResultData::GetItem.
Se esse identificador não estiver armazenado, ele poderá ser identificado usando IResultData::FindItemByLParam.
Esse método não dá suporte a listas virtuais.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| DLL | Mmcndmgr.dll |