OUT: User-defined external link traversal callback function
void **op_data
OUT: User-defined input data for the callback function
Hdf rm anchor
AnchorName
description
Description:
HTML Wrap
class
hdf-rm-section
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.
Hdf rm anchor
AnchorName
returns
Returns:
HTML Wrap
class
hdf-rm-section
Returns a non-negative value if successful; otherwise returns a negative value.
Failure Modes:
HTML Wrap
class
hdf-rm-section
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.
Hdf rm anchor
AnchorName
example
Example Usage:
HTML Wrap
class
hdf-rm-section
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);
