Last modified: 21 March 2012
Name: H5Pget_mcdt_search_cb
Signature:
herr_t H5Pget_mcdt_search_cb( hid_t ocpypl_id, H5O_mcdt_search_cb_t *func, void **op_data )

Purpose:
Retrieves the callback function from the specified object copy property list.

Description:
H5Pget_mcdt_search_cb retrieves the user-defined callback function and the user data that are set via H5Pset_mcdt_search_cb in the object copy property list ocpypl_id.

The callback function will be returned in the parameter func and the user data will be returned in the parameter op_data.

Parameters:
hid_t ocpypl_id      IN: Object copy property list identifier
H5O_mcdt_search_cb_t *func   OUT: User-defined callback function
void **op_data   OUT: User-defined input data for the callback function

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.

Failure Modes:
H5Pget_mcdt_search_cb will fail if the object copy property list is invalid.

See Also:
H5Ocopy
H5Pset_copy_object
  H5Pset_mcdt_search_cb
H5O_mcdt_search_cb_t

Copying Committed Datatypes
    with H5Ocopy
 
A comprehensive discussion of copying committed datatypes (PDF) in Advanced Topics in HDF5

History:
Release     Change
1.8.9 C function introduced in this release.