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 |