Retrieves a connector name for a VOL

Procedure:

H5VL_GET_CONNECTOR_NAME (id, name, size)

Signature:

<pre><code class="language-c">ssize_t H5VLget_connector_name(hid_t id, char *name/*out*/, size_t size)</code></pre>

<pre><code class="language-fortran">SUBROUTINE H5VLget_connector_name_f(obj_id, name, hdferr, name_len)
    IMPLICIT NONE
    INTEGER(HID_T), INTENT(IN) :: obj_id
    CHARACTER(LEN=*), INTENT(OUT) :: name
    INTEGER, INTENT(OUT) :: hdferr
    INTEGER(SIZE_T), OPTIONAL     :: name_len
 END SUBROUTINE H5VLget_connector_name_f</code></pre>

Parameters:
hid_t idIN: Object or file identifier
const char *nameOUT: Connector name
size_t sizeIN: Length of the name to retrieve

Description

H5VL_GET_CONNECTOR_NAME retrieves up to size elements of the VOL name  name associated with the object or file identifier id.

Passing in a NULL pointer for size will return the size of the connector name. This can be used to determine the size of the buffer to allocate for the name.

Returns:

Returns the length of the connector name on success, and a negative value on failure.

Example:

Coming Soon!

History:
ReleaseChange
1.12.0Function introduced