osf1 man page for evmeventcreate

EvmEventCreate(3)					     Library Functions Manual						 EvmEventCreate(3)

NAME
       EvmEventCreate, EvmEventCreateVa, EvmEventDup, EvmEventDestroy - Creates and destroys events

LIBRARY
       EVM Support Library (libevm.so, libevm.a)

SYNOPSIS
       #include <evm/evm.h>

       EvmStatus_t EvmEventCreate(
	       EvmEvent_t *event);

       EvmStatus_t EvmEventCreateVa(
	       EvmEvent_t *event,
	       [EvmItemId_t item_id,
	       const EvmItemValue_t item_value,]
	       ...
	       EvmITEM_NONE);

       EvmStatus_t EvmEventDup(
	       EvmEvent_t *dupev,
	       EvmEvent_t event);

       EvmStatus_t EvmEventDestroy(
	       EvmEvent_t event);

OPERANDS
       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 parameter, 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.

DESCRIPTION
       The EvmEventCreate() routine creates an empty event.  The newly created event is returned in the event reference argument.

       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 parameter 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 argument.

       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.

RESTRICTIONS
       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.

RETURN VALUES
       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.

ERRORS
       None

FILES
       None

SEE ALSO
       Commands: evmpost(1)

       Routines: EvmConnCreate(3) EvmEventPost(3) EvmItemSet(3) EvmEventWrite(3)

       Event Management: EVM(5)

       EVM Events: EvmEvent(5)
       delim off

																 EvmEventCreate(3)