IN/OUT: Dataset external storage prefix in UTF-8 or ASCII (Path and filename must be ASCII on Windows systems.)
IN: Size of prefix buffer in bytes
H5P_GET_EFILE_PREFIX retrieves the file system path prefix for locating external files associated with a dataset that uses external storage. This will be the value set with H5P_SET_EFILE_PREFIX or the HDF5 library’s default.
The value of size is the size in bytes of the prefix, including the NULL terminator. If the size is unknown, a preliminary H5P_GET_ELINK_PREFIX call with the pointer prefix set to NULL will return the size of the prefix without the NULL terminator.
The prefix buffer must be allocated by the caller. In a call that retrieves the actual prefix, that buffer must be of the size specified in size.
See H5P_SET_EFILE_PREFIX for a more complete description of file location behavior and for notes on the use of the HDF5_EXTFILE_PREFIX environment variable.
Returns the size of prefix and the prefix string will be stored in prefix if successful. Otherwise returns a negative value and the contents of prefix will be undefined.