Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > E

EvmEventCreate(3)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

EvmEventCreate(), EvmEventCreateVa(), EvmEventDestroy(), EvmEventDup() — create and destroy events

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 EvmEventDestroy( EvmEvent_t event ); EvmStatus_t EvmEventDup( EvmEvent_t *dupev, EvmEvent_t event );

Notes

Brackets [ ] are not part of the syntax; they denote optional parameters.

Library

EVM Support Library (libevm.so).

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 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 operand set to EvmITEM_NONE. The newly created event is returned in the event 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.

The EvmEventDup() 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 routine.

RETURN VALUE

EvmERROR_NONE

The operation completed without error.

EvmERROR_INVALID_ARGUMENT

One of the arguments to the function is invalid.

EvmERROR_INVALID_VALUE

A value in a structure member is invalid.

EvmERROR_NO_MEMORY

An operation failed because an attempt to acquire heap memory failed.

ERRORS

The value of errno 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).

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.