op_pk_nfd_get_pkt()
摘要
获取指定数据包中数据包字段的值,并会将某些字段类型的状态变为未设置(unset);目标字段通过名称指定。
语法
op_pk_nfd_get_pkt (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 |
Packet** |
用于存放指定字段值的变量 |
返回类型
Compcode
如果可以获取该字段的值则返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
{
/* variable declarations */
Packet *pkptr, *enc_pkptr;
/* obtain an arriving packet */
pkptr = op_pk_get (0);
/* decapsulate a higher-level packet from the arriving packet */
op_pk_nfd_get_pkt (pkptr, "packet_value", &enc_pkptr);
op_pk_print (enc_pkptr);
op_pk_destroy (pkptr);
}
详情
该函数会从数据包中移除指定字段。更多信息参见 op_pk_nfd_get() 的详情部分。
目的
提供一种获取数据包字段值的方式。该内核过程与 op_pk_nfd_get() 的工作方式完全相同,但仅适用于数据类型为数据包(packet)的数据包字段。完整的目的与详情参见 op_pk_nfd_get()。
错误
- 与 op_pk_nfd_get() 相同。
参考
- 与 op_pk_nfd_get() 相同。