Hook is not invoked

Question

I have a function I want to execute when a user finishes a quiz.

function wilson_random_task_quiz_finished($quiz, $score, $session_data) {
  // ...
}

When a user finishes a quiz, I think the hook should be invoked from the following code of the Quiz module.

/**
 * Actions to take at the end of a quiz
 *
 * @param $quiz
 *  The quiz node
 * @param $rid
 *  Result id
 * @param $score
 *  Score as a number
 */
function quiz_end_actions($quiz, $score, $session_data) {
  // Call hook_quiz_finished().
  module_invoke_all('quiz_finished', $quiz, $score, $session_data);

  if (!empty($quiz->aid)) {
    actions_do($quiz->aid, $quiz, $score, $session_data);
  }

  return $score;
}

My hook is not invoked. What am I missing?

Answer 1

2pha is correct: quiz_end_actions() is not necessarily called, contrary to what the code workflow could seem. In fact, quiz_take_quiz() contains the following code.

// Remove session variables, save $rid
$session_data = $_SESSION['quiz_' . $quiz->nid];
unset($_SESSION['quiz_' . $quiz->nid]);
// NOTE: End actions might redirect the user somewhere. Code below this line might not get executed...
quiz_end_actions($quiz, $score, $session_data);

As the comment says, end actions could redirect the user to somewhere else, and the code after it would not be executed.