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()。

错误

参考

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