HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

EvmConnSubscribe(3) EvmConnSubscribe(3)

events, through the connection’s callback function, with a reason code of

EvmREASON_TEMPLATE_INFO_DELIVERED

The ﬁrst time the function is called, a single event template is returned, if one is available. On subsequent

calls that have the ﬁlter_string parameter set to NULL, the next matching template is returned. The next

matching template continues to be returned until all templates that match the original ﬁlter_string have

been returned.

If it is necessary to match individual callback responses with their original requests, the caller must supply

a different user_arg for each request in the cycle. The caller must also verify that each incoming template

relates to the expected request.

Notes

The daemon does not return templates for which the user does not have access authorization.

To avoid missing incoming templates, do not issue a stream of

EvmConnRegistrationGet()

EvmConnTemplateScan()

requests before taking any callbacks. Work in a request/callback/request

cycle.

RETURN VALUE

EvmERROR_NONE The operation completed without error.

EvmERROR_INVALID_ARGUMENT

One of the arguments to the function was 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.

EvmERROR_NOT_PRESENT

For the EvmConnRegistrationGet() routine, the requested event

template is not registered.

For the

EvmConnTemplateScan()

routine, there is no match for the

speciﬁed ﬁlter_string, or the template list is exhausted.

EvmERROR_READ A read error occurred while reading from the EVM daemon connection.

EvmERROR_WRITE A write error occurred while writing to the EVM daemon connection.

ERRORS

The value of

errno is not set.