College Match - Get Contact by Hash API

The custom "first time login" form for Recommenders will use this new API to verify that the invoked URL is valid and matches the email address entered by the new user. It is invoked on form submit by the first time login form. If the user entered email matches the passed in values obtained from the query string - then the API returns the associated Drupal user ID so the login form postProcess can update the status and login fields for the Drupal user.

CRM_Quest_API::getContactByHash( $h, $m, $email )

Inputs
--------
$h (contact hash - from login URL query string)
$m (encrypted email from login URL query string)
$email (email address entered by the user on the login form)

Returns
----------
Either FALSE, if email does not match either the 'h' value (hashed contact's) primary email OR email doesn't match the 'm' value (encrypted email).

OR

drupal UID