H5Iremove_verify
(
hid_t id
,
H5I_type_t id_type
)
H5Iremove_verify
first ensures that
id
belongs to id_type
.
If so, it removes id
from internal storage
and returns the pointer to the memory it referred to.
This pointer is the same pointer that was placed
in storage by H5Iregister
.
If id
does not belong to id_type
,
then NULL
is returned.
The id
parameter is the ID which is to be removed from
internal storage.
Note: this function does NOT deallocate the memory that
id
refers to.
The pointer returned by H5Iregister
must be deallocated by the user to avoid memory leaks.
The type
parameter is the identifier for the ID type
which id
is supposed to belong to.
This identifier must have been created by a call to
H5Iregister_type
.
hid_t id |
IN: The ID to be removed from internal storage |
H5I_type_t type |
IN: The identifier of the type whose reference count is to be retrieved |
id
on success, NULL
on failure.