OpenTP1 Version 7 Programming Reference C Language
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. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.