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