op_pk_nfd_get_ptr()
摘要
获取指定数据包中结构(structure)字段的值,并会将某些字段类型的状态变为未设置(unset);目标字段通过名称指定。
语法
op_pk_nfd_get_ptr (pkptr, fd_name, value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
目标数据包 [数据包的指针可以从许多内核过程获得,包括 op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
fd_name |
const char* |
目标字段的名称 [该名称必须是数据包格式中已定义的字段,否则会发生错误。] |
value_ptr |
void** |
用于存放指定字段值的变量 |
返回类型
Compcode
如果可以获取该字段的值则返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
{
/* variable declarations */
Packet *pkptr; struct Custom_DS *ds_ptr;
/* obtain an arriving packet */
pkptr = op_pk_get (0);
/* extract a data structure from a packet field */
op_pk_nfd_get_ptr (pkptr, "structure_value", (void**)&ds_ptr);
op_pk_destroy (pkptr);
}
详情
该函数会从数据包中移除指定字段。更多信息参见 op_pk_nfd_get() 的详情部分。
目的
提供一种获取数据包字段值的方式。该内核过程与 op_pk_nfd_get() 的工作方式完全相同,但仅适用于数据类型为指针(pointer)的数据包字段。完整的目的与详情参见 op_pk_nfd_get()。
错误
- 与 op_pk_nfd_get() 相同。
参考
- 与 op_pk_nfd_get() 相同。