oms_pr_attr_set()
摘要
为进程注册表中已注册的进程设置属性及其值。
语法
oms_pr_attr_set (pr_handle, attr0_name, attr0_type, attr0_value,…, OPC_NIL)
| 参数 | 类型 | 说明 |
|---|---|---|
pr_handle |
OmsT_Pr_Handle |
发布属性的进程的进程注册表进程记录句柄 [进程注册表进程记录句柄可通过内核过程 oms_pr_process_register() 获得,或作为进程发现机制的结果获得。] |
attr0_name |
char * |
要设置的属性名称。 |
attr0_type |
int |
要设置的属性的数据类型(参见详细说明)。 |
attr0_value |
Vartype |
要设置的属性的值。 |
OPC_NIL |
序列终止符。 |
返回类型
Compcode
完成代码,指示属性设置过程是否成功。
[该返回代码可与常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 比较,以确定结果。]
详细说明
该过程为某个已注册进程的某个属性赋值。如果该属性尚不存在,则为该进程创建该属性。如果该属性已存在且类型不匹配,则更改其类型和值。
该过程的参数构成一个变长序列的名称-类型-值三元组,以符号常量 OPC_NIL 终止。可以设置以下属性类型:
- OMSC_PR_OBJID
- OMSC_PR_STRING
- OMSC_PR_NUMBER
- OMSC_PR_STRINGLIST
- OMSC_PR_PROHANDLE
- OMSC_PR_ADDRESS
有关这些属性类型的更多详细说明,参见附加属性。