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.