api_delete_history
List of: Functions
Subjects: History and Roll
Contents: Kernel

Action: Deletes the HISTORY_STREAM and all ENTITYs in the stream.

Prototype: outcome api_delete_history (


HISTORY_STREAM* hs // input history stream



= NULL


);

Includes: #include "kernel/acis.hxx"

#include "kernel/kernapi/api/api.hxx"

#include "kernel/kernapi/api/kernapi.hxx"

#include "kernel/kerndata/bulletin/bulletin.hxx"

Description: Deletes the HISTORY_STREAM and all ENTITYs associated with BULLETIN on the HISTORY_STREAM. Therefore, no ENTITYs will be deleted when logging is off. Uses the default HISTORY_STREAM if none is supplied.

Errors: Fails when unable to remove all ENTITYs referred to in the stream.

Limitations: Logging must be used.

Library: kernel

Filename: kern/kernel/kernapi/api/kernapi.hxx

Effect: System routine
PDF/KERN/16FNA.PDF
HTM/DATA/KERN/KERN/16FNA/0033.HTM