Método IResultData::InsertItem (mmc.h)
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 |