Last modified: 11 May 2011
Name: H5Pget_create_intermediate_group
Signature:
  herr_t `H5Pget_create_intermediate_group`( hid_t `lcpl_id`, unsigned *`crt_intermed_group` )

Purpose:
  Determines whether property is set to enable creating missing intermediate groups.

Description:
  `H5Pget_create_intermediate_group` determines whether the link creation property list `lcpl_id` is set to allow functions that create objects in groups different from the current working group to create intermediate groups that may be missing in the path of a new or moved object.

  Functions that create objects in or move objects to a group other than the current working group make use of this property. `H5Gcreate_anon` and `H5Lmove` are examples of such functions.

  If `crt_intermed_group` is true, missing intermediate groups will be created; if `crt_intermed_group` is false, missing intermediate groups will not be created.

Parameters:

  hid_t `lcpl_id` | IN: Link creation property list identifier
  unsigned *`crt_intermed_group` | OUT: Flag specifying whether to create intermediate groups upon creation of an object

Returns:
  Returns a non-negative valule if successful; otherwise returns a negative value.

Fortran90 Interface:
  None.

History:

  Release | C
  1.8.0 | Function introduced in this release.