Метод IResultData::InsertItem (mmc.h)
Метод IResultData::InsertItem позволяет оснастке добавить один новый элемент в представление области результатов.
Синтаксис
HRESULT InsertItem(
[in, out] LPRESULTDATAITEM item
);
Параметры
[in, out] item
Указатель на структуру RESULTDATAITEM , содержащую сведения о добавляемом элементе.
После вставки элемента mmc назначает ему уникальный идентификатор (идентификатор элемента) и возвращается через элемент itemID структуры, на который указывает параметр item. Имейте в виду, что значение itemID является дескриптором HRESULTITEM вставленного элемента. Оснастка должна хранить это значение, чтобы впоследствии управлять вставленным элементом путем вызова таких методов, как IResultData::GetItem.
Если этот идентификатор не хранится, его можно найти с помощью IResultData::FindItemByLParam.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
Маска и все соответствующие поля в структуре RESULTDATAITEM должны быть заполнены. Вложенные элементы невозможно вставить, но их можно задать. Таким образом, элемент nCol структуры элемента должен быть равен нулю.
Член str объекта RESULTDATAITEM должен иметь значение MMC_CALLBACK.
После вставки элемента mmc назначает ему уникальный идентификатор (идентификатор элемента) и возвращается через элемент itemID структуры, на который указывает параметр item. Имейте в виду, что значение itemID является дескриптором HRESULTITEM вставленного элемента. Оснастка должна хранить это значение, чтобы впоследствии управлять вставленным элементом путем вызова таких методов, как IResultData::GetItem.
Если этот идентификатор не хранится, его можно идентифицировать с помощью IResultData::FindItemByLParam.
Этот метод не поддерживает виртуальные списки.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |
| DLL | Mmcndmgr.dll |