Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5P_GET_ELINK_CB

Retrieves the external link traversal callback function from the specified link access property list

H5P_GET_ELINK_CB ( lapl_id, func, op_data )

herr_t H5Pget_elink_cb(
            hid_t lapl_id,
            H5L_elink_traverse_t *func,
            void **op_data
        )

  

NONE

hid_t lapl_idIN: Link access property list identifier
H5L_elink_traverse_t *funcOUT: User-defined external link traversal callback function
void **op_dataOUT: User-defined input data for the callback function

H5P_GET_ELINK_CB retrieves the user-defined external link traversal callback function defined in the specified link access property list.

The callback function may adjust the file access property list and file access flag to use when opening a file through an external link. The callback will be executed by the HDF5 Library immediately before opening the target file.

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

H5P_GET_ELINK_CB will fail if the link access property list identifier, lapl_id, is invalid.

An invalid function pointer or data pointer, func or op_data respectively, may cause a segmentation fault or an invalid memory access.

The following code retrieves the external link callback settings on the link access property list lapl_id into local variables:

H5L_elink_traverse_t elink_callback_func;
void *elink_callback_udata;
status = H5Pget_elink_cb(lapl_id, &elink_callback_func, &elink_callback_udata);

 

Release    Change
1.8.3C function introduced in this release.

--- Last Modified: December 14, 2017 | 12:46 PM