EvmEventCreate(3)EvmEventCreate(3)NAMEEvmEventCreate(), EvmEventCreateVa(), EvmEventDestroy(), EvmEventDup()
- create and destroy events
Brackets [ ] are not part of the syntax; they denote optional parame‐
EVM Support Library
event The event to be created, copied, or destroyed.
item_id The identifier for the Event Data Item to be set. See
the EvmItemSet(3) manpage for possible values for this
operand, and the data contained by the data item.
item_value The value to be stored in the associated item indicated
dupev The return location where the duplicate (new) event is
The routine creates an empty event. The newly created event is
returned in the event reference argument.
The 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 oper‐
and set to The newly created event is returned in the event reference
The 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.
The routine creates a copy of the supplied event and returns the new
event in the dupev reference argument.
To avoid memory leakage, all structures that are supplied to the caller
from API routines must be freed with the appropriate EVM API free rou‐
The operation completed without error.
One of the arguments to the function is invalid.
A value in a structure member is invalid.
An operation failed because an attempt to acquire heap memory failed.
The value of is not set.