op_pk_fd_access_ptr()

摘要

访问指定数据包中存储的结构;目标字段由数字索引指定。

语法

op_pk_fd_access_ptr (pkptr, field_index, struct_pptr)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
field_index int 目标字段的数字索引
[该值必须为非负数。]
struct_pptr void** 指向一个变量的指针,该变量将被填入所访问的结构。该变量本身必须是指向某个数据结构的指针。

返回类型

Compcode

若字段未获取成功则返回 OPC_COMPCODE_FAILURE,否则返回 OPC_COMPCODE_SUCCESS。

示例

/* Access the datagram field information structure													*/
/* to assign source address information.													*/
op_pk_fd_access_ptr (pk_copy_ptr, pk_fd_index, (void**)&pkt_fields_ptr);

/* Set the source address before forwarding the packet. */
pkt_fields_ptr->src_addr = iface_ptr->addr_range_ptr->address;
pkt_fields_ptr->src_internal_addr = ip_rtab_addr_convert (iface_ptr->addr_range_ptr->address);

详情

若成功,*struct_pptr 将被设置为数据包中存储的结构的地址。该结构不会从数据包中被移除(op_pk_fd_get_ptr() 则会在访问时将其移除)。使用 *struct_pptr 所做的任何修改都将作用于数据包中的该结构。

注意: 该内核过程只应用于访问结构型数据包字段。访问其他类型的字段将导致错误。对于数值型字段,请使用某一类型化的 op_pk_fd_get… 内核过程。

警告: 由于该内核过程在访问结构字段的值时不会将其移除,多个进程可能同时在同一对象上工作,从而可能无意中相互影响。

用途

提供一种使用字段索引(而非字段名称)访问存储在数据包内部结构的机制。

错误

  • 程序中止:Segmentation violation.(由于无效的 pkptr 或 struct_pptr 参数)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包。
  • 程序中止:数据包指针指向无主数据包(<pk_id>)。
  • 可恢复错误:数据包(<pk_id>)的字段(<field_index>)类型为(<field_type>)。
  • 可恢复错误:字段索引(<field_index>)超出数据包(<pk_id>)的范围。
  • 可恢复错误:数据包(<pk_id>)中不存在索引为(<field_index>)的字段。
  • 可恢复错误:数据包(<pk_id>)的内容是值向量。数据包不允许字段操作。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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