Last modified: 2 September 2015
Name: H5PLget_loading_state
Signature:
  herr_t `H5PLget_loading_state`( int *`plugin_flags` )

Purpose:
  Query state of the loading of dynamic plugins.

Description:
  `H5PLget_loading_state` retrieves the state of the dynamic plugins flag, `plugin_flags`.

  Types of plugins that are subject to programmatic control are listed in the definition of the `H5PL_type_t` ENUM. That list is presented in the “Plugin Type/Bit Position” table in the `H5PLset_loading_state` reference manual entry.

Parameters:

  int `plugin_flags` | OUT: List of dynamic plugin types that are enabled or disabled. A plugin bit set to `0` (zero) indicates that that dynamic plugin is disabled. A plugin bit set to `1` (one) indicates that that dynamic plugin is enabled. If the value of `plugin_flags` is negative, all dynamic plugins are enabled. If the value of `plugin_flags` is `0` (zero), all dynamic plugins are disabled.

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

Example Usage:

      /* Disable plugin X: Requires user to negate the state
       * with a 0 in bit position X and AND it with the result
       * from an H5PLget_loading_state call. */

      H5PLget_loading_state(&curr_setting);
      int new_setting = curr_setting & ~H5PL_FILTER_PLUGIN ;
      H5PLset_loading_state (new_setting);

Fortran Interface:
  None.

See Also:
  `H5PLset_loading_state`

  “Dynamic Plugins in HDF5”

History:

  Release | C
  1.8.15 | Function introduced in this release.