Returns the position in the hook chain the currently executing hook occupies

Behaviour

  • If the hook is being strongly executed then flag this specific hook in the chain for Again As Weak Execution.
  • If the originating transaction successfully is applied then the hook will be called again in a second, Weak Execution.

Definition

int64_t hook_again (void);

Example

int64_t result = 
    hook_again();

Parameters

This API has no parameters

Return Code

TypeDescription
int64_t1 iff successfully flagged for Again As Weak.

PREREQUISITE_NOT_MET
- This hook is already being executed weakly at the time of the call.

ALREADY_SET
- The function was already called this execution.