IResultData::InsertItem 方法 (mmc.h)

IResultData::InsertItem 方法使管理单元能够将单个新项添加到结果窗格视图。

语法

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

parameters

[in, out] item

指向 RESULTDATAITEM 结构的指针,该结构包含有关要添加的项的信息。

插入项后,MMC 将向其分配一个唯一标识符 (项 ID) ,并通过 item 参数指向的结构的 itemID 成员返回。 请注意, itemID 值是插入项的 HRESULTITEM 句柄。 管理单元应存储此值,以便稍后通过调用 IResultData::GetItem 等方法操作插入的项。

如果未存储此标识符,可以使用 IResultData::FindItemByLParam 查找该标识符。

返回值

此方法可以返回其中一个值。

注解

应填写 RESULTDATAITEM 结构中的掩码和所有适当的关联字段。子项不能插入,但可以设置。 因此,项结构的 nCol 成员必须为零。

RESULTDATAITEM 的 str 成员必须设置为 MMC_CALLBACK

插入项后,MMC 将向其分配一个唯一标识符 (项 ID) ,并通过 item 参数指向的结构的 itemID 成员返回。 请注意, itemID 值是插入项的 HRESULTITEM 句柄。 管理单元应存储此值,以便稍后通过调用 IResultData::GetItem 等方法操作插入的项。

如果未存储此标识符,则可以使用 IResultData::FindItemByLParam 进行标识。

此方法不支持虚拟列表。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h
DLL Mmcndmgr.dll

另请参阅

IResultData

IResultData2