OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

dc_prf_get_trace_num - Report the sequential number for an acquired performance verification trace

Format

ANSI C, C++

#include <dcprf.h>
int dc_prf_get_trace_num(unsigned short *trace_num,
                         DCLONG flags)

K&R C

#include <dcprf.h>
int dc_prf_get_trace_num(trace_num, flags)
unsigned short *trace_num;
DCLONG      flags;

Description

The function dc_prf_get_trace_num() reports the acquired sequential trace number within the process of the latest performance verification trace (prf trace) acquired before the function was called. It reports this information to the function call source.

If no performance verification trace has been acquired in the process that called the function dc_prf_get_trace_num(), the acquired sequential trace number is 0.

Arguments whose values are set in the UAP

trace_num

Specify the leading pointer of the area in which you want to set the sequential number for an acquired performance verification trace.

flags

Specify DCNOFLAGS.

Return values

Return value Return value (numeric) Explanation
DC_OK 0 Normal termination.
DCPRFER_PARAM -4601 The value specified for an argument is invalid.