Called by a hook to set the new candidate object name or location to value.

Has no effect if called outside a hook.