trc_free 子例程

在线编辑

用途

释放由 读取的 trc_read， Trc_find， trc_loginfo或 trc_hookname 子例程分配的内存。

库

libtrace.a

语法

#include <sys/libtrace.h>

int trc_free (parmp)
void *parmp;

描述

trc_Free 子例程用于释放与跟踪检索 API 所返回的数据结构相关联的内存。 它不会为基本结构释放存储器，但是，仅代表用户由 API 分配的存储器。 该指针必须指向下列其中一项:
trc_read_t
读取的 trc_read 或 Trc_find 子例程返回的数据。
trc_loginfo_t
trc_loginfo 子例程返回的数据。
trc_hookname_t
trc_hookname 子例程返回的数据。
trc_logpos_t
特尔克特尔 子例程返回的日志位置对象。

必须使用 特尔克 子例程以释放日志句柄 trc_loghandle_t。

例如， trc_free(&trc_data)(其中 trc_data 的类型为 trc_read_t) 将释放 trc_data 结构所引用的存储器，但不会释放 trc_data ，因为它必须由用户预先分配。

参数

项 描述
帕姆普 指向上面描述的结构。

返回值

成功完成后， trc_Free 子例程返回 0。

错误代码

项 描述
EINVAL 帕姆普 参数指向不受支持的数据类型。