EvmEventCreate(3)EvmEventCreate(3)NAMEEvmEventCreate(), EvmEventCreateVa(), EvmEventDestroy(), EvmEventDup()
- create and destroy events
SYNOPSIS
Notes
Brackets [ ] are not part of the syntax; they denote optional parame‐
ters.
Library
EVM Support Library
Parameters
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
by item_id.
dupev The return location where the duplicate (new) event is
stored.
DESCRIPTION
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
argument.
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.
Notes
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‐
tine.
RETURN VALUE
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.
ERRORS
The value of is not set.
SEE ALSO
Commands
evmpost(1).
Routines
EvmConnCreate(3)EvmEventPost(3)EvmItemSet(3)EvmEventWrite(3).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
EvmEventCreate(3)