Guardian Procedure Calls Reference Manual
The stack tracing mechanism failed while attempting to trace back to the calling procedure.
HIST_MISSING_HOOK-11
This error is not returned in the D40 RVU.
HIST_TOO_SHORT-12
A workspace length is less than the size of the NSK_histWorkspace structure.
HIST_BAD_PIN-13
An invalid argument (pin) is passed.
HIST_BAD_HOOK-14
Unable to read the unwind information associated with the specified function.
HIST_BAD_SESSION-15
An invalid session handle is passed.
HIST_BAD_PARAM-16
An invalid parameter is passed.
HIST_BAD_INFO_SIZE-17
The buffer argument size is null.
HIST_BAD_INFO-18
A context value is not supported.
HIST_NO_UNWIND_INFO-20
Stack unwind information cannot be located for the function.
HIST_BAD_UNWIND_INFO-21
Inconsistencies are detected in the unwind information while processing the descriptor.
HIST_SKIPPED_ALL-22
Complete stack trace is bypassed.
HIST_CANT_CONTINUE-23
An internal error occurred while unwinding the stack.
HIST_INTERNAL_ERROR-24
An internal error occurred while unwinding the stack.
HIST_FAILURE-99
An error is encountered while reading a value from the memory.
Considerations
• Suppression of a stack frame by HIST_INIT_ or HIST_PRIOR_ is determined by a bit mask in
the field workspace.FrameSuppress. The HIST_INIT_ procedure initializes the field to a
default set of transition frames, or to zero (0) if the HO_NoSuppress option of HIST_INIT_ is
specified in the call to HIST_INIT_.
HIST_INIT_ examines the FrameSuppress field at least once after initializing it. To prevent
suppression of initial frames, you need to set the HO_NoSuppress option.
• On return from the HIST_INIT_ procedure, the designated procedure context is ready for
examination and display. If that context is suppressed (and the HO_NoSuppress option is not
specified), then the next previous unsuppressed context is available. If no unsuppressed context
is available, HIST_INIT_ returns an error.
• Stack tracing
The HIST_INIT_ procedure is used with the HIST_FORMAT_ and HIST_GETPRIOR_ procedures
to perform stack tracing. HIST_INIT_ is called first to initialize a workspace and determine the
HIST_INIT_ Procedure 719