This isn't going to tell you or give you code examples.
This post is to give you the one piece of information that seems to be lacking in most posts on the subject. The following functions all have this issue.
- The getMyProperties method and the getPropertiesFor method return a PersonProperties object.
- The getUserProfilePropertiesFor method and the getUserProfilePropertyFor method return the values of the user profile properties that you specify.
There is an unknown requirement not detailed here or elsewhere.
You must have the "My Site Host" setup and you must have the URL to the "My Site Host" setup in UPS (User Profile Service). Else these functions will not work.
Hope this helps someone not waste time.