pips_event_new_subscriber_handler_t

Updated: April 19, 2023

Prototype of handlers for new subscriber events

Synopsis:

#include <pips/event.h>
typedef int pips_event_new_subscriber_handler_t(void *user_data,
                                                pips_entity_t *const entity,
                                                pips_guid_t guid);

Arguments:

user_data
A pointer to the user data that was supplied when the callback was registered
entity
A pointer to the entity for which there is a new subscriber
guid
The GUID of the new subscriber

Library:

pips-client

Description:

This data type describes the prototype for callback functions that can be registered by clients to handle new subscriber events from the PiPS framework.

Returns:

The event framework expects that the handler will return a negative value and set errno if it encounters an error condition, and return a value greater than or equal to zero on success.