NAME

DsExecutionAbort − Abort traversal of the current method

SYNOPSIS

C:

void DsExecutionAbort()

FORTRAN:

CALL DSEA()

DESCRIPTION

DsExecutionAbort aborts traversal of the current method.  Callback objects may conditionally affect traversal of display or definition hierarchies into which they are placed by calling DsExecutionAbort.  This causes the entire traversal to halt. 

The traversal will halt only upon return from the callback function that called DsExecutionAbort.  In other words, the callback function will be allowed to finish, but no other objects will be executed after it in the same traversal. 

ERRORS

DsExecutionAbort will fail if called outside of a traversal method; the call to DsExecutionAbort will be ignored. 

[WARNING - no traversal in progress]

SEE ALSO

DoCallback(3D), DsExecuteObj(3D), DsExecutionReturn(3D)

September 02, 1992