17.2.376. MPI_T_event_handle_free

MPI_T_event_handle_free - Free event handles

17.2.376.1. SYNTAX

17.2.376.1.1. C Syntax

#include <mpi.h>

int MPI_T_event_handle_free(MPI_T_event_registration event_registration,
                            void *user_data, MPI_T_event_free_cb_function free_cb_function)

17.2.376.2. INPUT PARAMETERS

  • user_data: Pointer to a user-controlled buffer.

  • free_cb_function: Pointer to user-defined callback function.

17.2.376.3. INPUT/OUTPUT PARAMETERS

  • event_registration: Event registration.

17.2.376.4. DESCRIPTION

MPI_T_event_handle_free frees a handle allocated by MPI_T_event_handle_alloc.

17.2.376.5. ERRORS

MPI_T_event_handle_free 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