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

Action: Merges a DELTA_STATE instance into a HISTORY_STREAM.

Prototype: outcome api_add_state (


DELTA_STATE* ds, // state to add


HISTORY_STREAM* hs // stream to add


);

Includes: #include "kernel/acis.hxx"

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

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

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

Description: This API grafts a DELTA_STATE into a HISTORY_STREAM following the active DELTA_STATE of the stream. This is used to in conjunction with api_note_state and api_remove_state to build multiple independent history streams. After noting a state, it can be moved the an alternate stream by removing it from the default stream, with api_remove_state, and adding it to the stream it is to become a part of.

Errors: Either input pointer is NULL.

Library: kernel

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

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