Método IResultData::InsertItem (mmc.h)

  • Artículo

El método IResultData::InsertItem permite al complemento agregar un solo elemento nuevo a la vista del panel de resultados.

Sintaxis

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

Parámetros

[in, out] item

Puntero a una estructura RESULTDATAITEM que contiene información sobre el elemento que se va a agregar.

Una vez insertado el elemento, MMC le asigna un identificador único (un identificador de elemento) y se devuelve a través del miembro itemID de la estructura a la que apunta el parámetro item. Tenga en cuenta que el valor itemID es el identificador HRESULTITEM del elemento insertado. El complemento debe almacenar este valor para manipular posteriormente el elemento insertado llamando a métodos como IResultData::GetItem.

Si no se almacena este identificador, se puede buscar con IResultData::FindItemByLParam.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

La máscara y todos los campos asociados adecuados de la estructura RESULTDATAITEM deben rellenarse. Los subelementos no se pueden insertar, pero se pueden establecer. Por lo tanto, el miembro nCol de la estructura de elementos debe ser cero.

El miembro str de RESULTDATAITEM debe establecerse en MMC_CALLBACK.

Una vez insertado el elemento, MMC le asigna un identificador único (un identificador de elemento) y se devuelve a través del miembro itemID de la estructura a la que apunta el parámetro item. Tenga en cuenta que el valor itemID es el identificador HRESULTITEM del elemento insertado. El complemento debe almacenar este valor para manipular posteriormente el elemento insertado llamando a métodos como IResultData::GetItem.

Si no se almacena este identificador, se puede identificar mediante IResultData::FindItemByLParam.

Este método no admite listas virtuales.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado mmc.h
Archivo DLL Mmcndmgr.dll

Consulte también

IResultData

IResultData2