Sets prefix to be applied to VDS source file paths

Procedure:

H5P_SET_VIRTUAL_PREFIX ( dapl_id, prefix )

Signature:

<pre><code class="language-c">herr_t H5Pset_virtual_prefix(
        hid_t dapl_id,
        const char *prefix
    )
  </code></pre>

<pre><code class="language-fortran">Replace this text with the Fortran function signature</code></pre>

Parameters:
hid_t dapl_idIN: Dataset access property list identifier
const char *prefix    IN: Prefix to be applied to VDS source file paths

Description:

H5P_SET_VIRTUAL_PREFIX sets the prefix to be applied to the path of any VDS source files traversed. The prefix is prepended to the filename stored in the VDS virtual file, set with H5P_SET_VIRTUAL.

The prefix is specified in the user-allocated buffer prefix and set in the dataset access property list dapl_id. The buffer should not be freed until the property list has been closed.

Returns:

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

Example:

Coming Soon!

History:
Release    C
1.10.2Function introduced in this release.