Retrieves a connector name for a VOL
Procedure:
H5VL_GET_CONNECTOR_NAME (id, name, size)
Signature:
ssize_t H5VLget_connector_name(hid_t id, char *name/*out*/, size_t size)
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
Parameters:
hid_t id | IN: Object or file identifier |
const char *name | OUT: Connector name |
size_t size | IN: 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:
History:
| Release | Change |
|---|
| 1.12.0 | Function introduced |
--- Last Modified: August 14, 2019 | 03:07 PM
