EvmEventCreate, EvmEventCreateVa, EvmEventDup, EvmEventDestroy
- Creates and destroys events
EvmEvent_t *event ); EvmStatus_t EvmEventCreateVa(
const EvmItemValue_t item_value]...,
EvmITEM_NONE ); EvmStatus_t EvmEventDup(
EvmEvent_t event ); EvmStatus_t EvmEventDestroy(
EvmEvent_t event );
The event to be created, copied, or destroyed. The identifier
for the Event Data Item to be set. See the EvmItemSet(3) reference page for possible values for this
operand, and the data contained by the data item. The
value to be stored in the associated item indicated by
item_id. The return location where the duplicate (new)
event is stored.
The EvmEventCreate() routine creates an empty event. The
newly created event is returned in the event reference
The EvmEventCreateVa() routine creates an event and adds
the supplied items in a single call. The item list is terminated
by an instance of the item_id operand set to
EvmITEM_NONE. The newly created event is returned in the
event reference argument.
The EvmEventDup() routine creates a copy of the supplied
event and returns the new event in the dupev reference
The EvmEventDestroy() routine destroys a previously created
event, freeing its memory. This function must be used
if it is necessary to destroy an event, to ensure that all
associated memory is freed.
To avoid memory leakage, all structures that are supplied
to the caller from API routines must be freed with the
appropriate EVM API free routine.
The operation was completed without error. One of the
arguments to the function was invalid. A value in a
structure member is invalid. An operation failed because
an attempt to acquire heap memory failed.
EVM Support Library (libevm.so, libevm.a)
Routines: EvmConnCreate(3) EvmEventPost(3) EvmItemSet(3)
Event Management: EVM(5)
EVM Events: EvmEvent(5)
[ Back ]