Last modified: 9 October 2014
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`.
See Also:
  “Using Identifiers”

History:

  Release | C
  1.8.0 | Function introduced in this release.