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

Action: Returns a DELTA_STATE identified by the given id.

Prototype: outcome api_get_state_from_id (


STATE_ID id, // id of the DELTA_STATE


DELTA_STATE*& returned_ds,// returned DELTA_STATE


HISTORY_STREAM* hs // history where the



= NULL // ENTITY lives


);

Includes: #include "kernel/acis.hxx"

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

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

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

Description: Returns the pointer to the DELTA_STATE identified by id. If no HISTORY_STREAM is specified, the default stream is used. If the DELTA_STATE corresponding to the id is not in the stream, a NULL pointer is returned.

Errors: id is not valid in the given stream.

Library: kernel

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

Effect: Read-only
PDF/KERN/16FNA.PDF
HTM/DATA/KERN/KERN/16FNA/0068.HTM