op_pk_nfd_access()

摘要

获取指定数据包中某个整数、double、结构或信息字段的值,字段保持不变;目标字段由名称指定。

语法

op_pk_nfd_access (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* 指向某个变量的指针,用于填入指定字段的值
[此参数可以接受除 packet 以外任何数据类型的指针。参数指针的数据类型必须与指定字段的数据类型一致,否则会发生错误。]

返回类型

Compcode

完成代码,指示是否成功获取指定字段的值。如果发生错误(例如字段缺失),将返回常量 OPC_COMPCODE_FAILURE。

示例

/* Access the datagram field information structure */
/* to assign source address information.               */
op_pk_nfd_access (pk_copy_ptr, “fields”, &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);

详情

该内核过程支持访问任意数据类型(packet 除外)的数据包字段。structure 类型字段的值会被复制到传入的变量中,但除此之外不受影响(即结构字段仍然保持置位且可访问,并继续为数据包的总大小贡献相同的比特数)。

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

对于 integer、double 和 information 类型的字段,该内核过程的行为与 op_pk_nfd_get() 相同。

用途

提供获取数据包字段值的机制。该内核过程实现的功能与 op_pk_nfd_get() 完全相同,不同之处在于

  • structure 类型的字段不会从数据包中被剥离
  • packet 类型的字段不受支持

错误

  • 程序中止:段错误。(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已被销毁的数据包。
  • 程序中止:数据包指针指向不属于自己的数据包(<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