Function
GLibHookfirst_valid
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.)
This function is not directly available to language bindings.
Parameters
hook_list-
Type:
GHookListA
GHookList.The data is owned by the caller of the function. may_be_in_call-
Type:
gbooleanTRUEif hooks which are currently running (e.g. in another thread) are considered valid. If set toFALSE, these are skipped.
Return value
Type: GHook
The first valid GHook, or NULL if none are valid.
| The data is owned by the called function. |