pips_event_remove_all_handlers()

Updated: April 19, 2023

De-register all event handlers for a provider

Synopsis:

#include <pips/event.h>
int pips_event_remove_all_handlers(pips_provider_t *const provider_handle,
                                   void *const user_data)

Arguments:

provider_handle
A pointer to the provider for which the event handlers are being de-registered
user_data
A pointer to the user data buffer associated with the event handlers being de-registered. This argument can be NULL to de-register all handlers.

Library:

pips-client

Description:

This function de-registers all event handlers associated with the given user data for the specified provider. This function should be called before deleting the user data to prevent the event handlers from being invoked with invalid user data.

Returns:

EOK
All event handlers were successfully de-registered
-1
An error occurred while de-registering one or more of the handlers (errno is set)

Errors:

  • ENODEV: The provider argument is invalid.