Guardian Programming Reference Summary for C

Functions Summary (G-N)
Guardian Programming Reference Summary for C—522630-001
6-9
HIST_GETPRIOR_
Establishes a previous procedure call as the process context for display by the next
HIST_FORMAT_ procedure call. See the HIST_INIT_ procedure for an overview of
how HIST_INIT_, HIST_FORMAT_, and HIST_GETPRIOR_ can be used together to
perform stack tracing.
return value:
HIST_INIT_
Initializes a process history display or stack trace. It validates a parameter and
establishes the context to display and from which to begin tracing.
return value:
#include <histry.h>
short HIST_GETPRIOR_
( NSK_histWorkspace *workspace ); /* i,o */
0 = HIST_OK
The procedure executed successfully.
-8 = HIST_ERROR
The stack tracing mechanism failed.
-9 = HIST_BAD_WORKSPACE
The workspace structure has an invalid version identifier. This error can occur
if HIST_GETPRIOR_ is called without first calling the HIST_INIT_
procedure or if the workspace structure has become corrupted.
#include <histry.h>
short HIST_INIT_ ( NSK_histWorkspace *workspace /* i,o */
,const uint32 version /* i */
,const uint16 options /* i */
,const void *context ); /* i */
0 = HIST_OK
The procedure terminated normally.
-3 = HIST_BAD_VERSION
An invalid value was specified for the version parameter.
-4 = HIST_BAD_OPTION
An invalid value was specified for the options parameter. An undefined bit
was set.