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
有关这些属性类型的更多详细说明,参见附加属性。