17.2.381. MPI_T_event_set_dropped_handler
MPI_T_event_set_dropped_handler — Registers a function to be called when event information is dropped for the registration handle specified in event_registration
17.2.381.1. SYNTAX
17.2.381.1.1. C Syntax
#include <mpi.h>
int MPI_T_event_set_dropped_handler(MPI_T_event_registration event_registration,
MPI_T_event_dropped_cb_function dropped_cb_function)
17.2.381.2. INPUT PARAMETERS
event_registration
: Event registrationdropped_cb_function
: pointer to user-defined callback function
17.2.381.3. DESCRIPTION
MPI_T_event_set_dropped_handler registers the function
dropped_cb_function
to be called by the MPI implementation when event information is
dropped for the registration handle specified in event_registration
.
17.2.381.4. ERRORS
MPI_T_event_set_dropped_handler will fail if:
MPI_T_ERR_NOT_INITIALIZED
: The MPI Tools interface is not initialized.MPI_T_ERR_INVALID_HANDLE
: The handle is invalid.MPI_T_ERR_INVALID_HANDLE
: Invalid use of the interface or bad parameter values(s).MPI_T_ERR_OTHER
: Other error