oms_pr_process_discover()

摘要

通过匹配指定的属性,从注册表中已注册的进程集合中发现一个或多个进程。

语法

oms_pr_process_discover (neighbor_objid, pr_handle_lptr, attr0_name, attr0_type, attr0_value,...., OPC_NIL)

参数 类型 说明
neighbor_objid Objid 仅考虑其邻居来发现进程的模块的对象标识符
[如果将其指定为 OPC_OBJID_INVALID,则考虑所有模块中的进程。]
pr_handle_lptr List * 用于存储发现过程结果的列表指针(参见详细说明)。
attr0_name char * 要匹配的属性名称。
attr0_type int 要匹配的属性的数据类型(参见详细说明)。
attr0_value Vartype 要匹配的属性的值。
OPC_NIL 序列终止符。

返回类型

Compcode

完成代码,指示进程发现过程是否匹配到任何进程。

[该返回代码可与常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 比较,以确定结果。]

示例

/* Allocate (and initialize) the list. */
pr_handle_lptr = prg_list_create ();

/* Obtain the process handles that match our query. */
result = oms_pr_process_discover (neighbor_objid, pr_handle_lptr,
	name, type, value,
	name, type, value,
	...
	OPC_NIL);

if (result == OPC_COMPCODE_SUCCESS)
{
	/* Query but do not modify the elements of the pr_handle_lptr */

	/* Remove the elements from the list when you are done, to avoid leaking linked
		list cells. */
	num_prs = op_prg_list_size (pr_handle_lptr);
	for (i = 0; i < num_prs; i++)
	{
		op_prg_list_remove (pr_handle_lptr, OPC_LISTPOS_TAIL);
	}
}

/* Now free the empty list as it is no longer going to be used. */
prg_mem_free (pr_handle_lptr);

详细说明

该函数为匹配特定属性值的进程获取进程注册表进程句柄。该过程的参数按名称-类型-值三元组分组,并且所有属性值必须与注册表记录中的值匹配才会返回匹配结果。若没有已注册的进程与指定属性匹配,则返回失败状态。

该过程的参数构成一个变长序列的名称-类型-值三元组,以符号常量 OPC_NIL 终止。

通过 pr_handle_lptr 传入的列表应当已分配但为空(不包含任何元素)。pr_handle_lptr 中返回的元素不得由调用者释放,因为它们是进程句柄的只读副本。不过,可以通过 op_prg_list_remove() 从列表中移除这些元素;如有需要,可以释放 resulting 空列表结构。

可以指定以下属性类型:

  • OMSC_PR_OBJID
  • OMSC_PR_STRING
  • OMSC_PR_NUMBER
  • OMSC_PR_STRINGLIST
  • OMSC_PR_PROHANDLE
  • OMSC_PR_ADDRESS

有关这些属性类型的更多详细说明,参见附加属性。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com