Function

GLibHookfirst_valid

Declaration

GHook*
g_hook_first_valid (
  GHookList* hook_list,
  gboolean may_be_in_call
)

Description

Returns the first GHook in a GHookList which has not been destroyed. The reference count for the GHook is incremented, so you must call g_hook_unref() to restore it when no longer needed. (Or call g_hook_next_valid() if you are stepping through the GHookList.)

Parameters

hook_list GHookList
 

A GHookList.

 The data is owned by the caller of the function.
may_be_in_call gboolean
 

TRUE if hooks which are currently running (e.g. in another thread) are considered valid. If set to FALSE, these are skipped.

Return value

Returns: GHook
 

The first valid GHook, or NULL if none are valid.

 The data is owned by the called function.