Returns the index of the equipped hero for the client
Example:
heroIndex = GetEquippedHeroIndex( localClientNum )
* = mandatory