oms_pr_attr_get()
摘要
获取进程注册表中某个已注册进程的某个属性的值。
语法
oms_pr_attr_get (pr_handle, attr_name, attr_type, attr_value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pr_handle |
OmsT_Pr_Handle |
要获取其属性的进程的进程注册表进程记录句柄 [进程注册表进程记录句柄可作为进程发现机制的结果获得。] |
attr_name |
char * |
目标属性的名称。 |
attr_type |
int |
目标属性的数据类型(参见详细说明)。 |
attr_value_ptr |
Vartype * |
指向某个变量的指针,该变量将被填入目标属性的值。 |
返回类型
Compcode
完成代码,指示是否成功获取目标属性的值。
[该返回代码可与常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 比较,以确定结果。]
详细说明
该过程获取某个已注册进程的一个属性的值。如果目标属性在目标进程中不存在,则返回失败代码。
可以获取以下任一属性类型的值:
- OMSC_PR_OBJID
- OMSC_PR_STRING
- OMSC_PR_NUMBER
- OMSC_PR_STRINGLIST
- OMSC_PR_PROHANDLE
- OMSC_PR_ADDRESS
有关这些属性类型的更多详细说明,参见附加属性。