op_apptrack_pk_type_info_get()
摘要
获取数据包中的应用类型 ID。
语法
op_apptrack_pk_type_info_get (apptrack_hndl, pkptr, num_types, app_types_array)
| 参数 | 类型 | 说明 |
|---|---|---|
apptrack_hndl |
Apptrackhandle |
所关注的 ADT 状态。 |
pkptr |
SimT_Packet * |
所关注的数据包。 |
num_types |
int * |
用于填入 app_types_array 大小的区域。 |
app_types_array |
opT_uInt32 ** |
用于填入应用类型 ID 数组的区域。 |
返回类型
Compcode
若该内核过程成功完成则返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
详情
用户负责释放返回的数组。
用途
该内核过程返回已打标记数据包中承载的所有应用类型 ID 的数组。这在数据包分段与重组期间很有用,因为分段与重组可能使一个数据包具有多个应用类型。
错误
- 可恢复错误:参数 (
apptrack_hndl) 为 NIL。 - 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<packet ID>)。 - 程序中止:数据包指针指向静态数据包 (
<packet ID>)。 - 可恢复错误:参数 (
num_types) 为 NIL。 - 可恢复错误:参数 (
app_types_array) 为 NIL。 - 可恢复错误:应用实例 (
<instance_id>) 无效或已完成。
参考
- 使用内核过程 op_apptrack_pk_tag() 为数据包添加应用类型 ID。