Name: H5Pget_elink_prefix
Signature:
  ssize_t `H5Pget_elink_prefix`( hid_t `lapl_id`, char *`prefix`, size_t `size` )

Purpose:
  Retrieves prefix applied to external link paths.

Description:
  `H5Pget_elink_prefix` retrieves the prefix applied to the path of any external links traversed.

  When an external link is traversed, the prefix is retrieved from the link access property list `lapl_id`, returned in the user-allocated buffer pointed to by `prefix`, and prepended to the filename stored in the external link.

  The size in bytes of the prefix, including the `NULL` terminator, is specified in `size`. If `size` is unknown, a preliminary `H5Pget_elink_prefix` call with the pointer `prefix` set to `NULL` will return the size of the prefix without the `NULL` terminator.

Parameters:

  hid_t `lapl_id` | IN: Link access property list identifier
  char *`prefix` | OUT: Prefix applied to external link paths
  size_t `size` | IN: Size of prefix, including null terminator

Returns:
  If successful, returns a non-negative value specifying the size in bytes of the prefix without the `NULL` terminator; otherwise returns a negative value.

Fortran90 Interface:
  None.

History:

  Release | C
  1.8.0 | Function introduced in this release.