Last modified: 17 August 2010
Name: H5Gopen2
Signature:
hid_t H5Gopen2( hid_t loc_id, const char * name, hid_t gapl_id )

Purpose:
Opens an existing group with a group access property list.

Description:
H5Gopen2 opens an existing group, name, at the location specified by loc_id.

With default settings, H5Gopen2 provides similar functionality to that provided by H5Gopen1. The only difference is that H5Gopen2 can provide a group access property list, gapl_id.

H5Gopen2 returns a group identifier for the group that was opened. This group identifier should be released by calling H5Gclose when it is no longer needed.

Parameters:
hid_t loc_id IN: File or group identifier specifying the location of the group to be opened
const char *name     IN: Name of the group to open
hid_t gapl_id IN: Group access property list identifier
(No group access properties have been implemented at this time; use H5P_DEFAULT.)

Returns:
Returns a group identifier if successful; otherwise returns a negative value.

Fortran90 Interface: See listing under H5Gopen.

History:
Release     C
1.8.0 Function introduced in this release.