NameCtrl.GetStatus Method

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Returns the online status of a user, typically to draw the pawn icon.

expression.GetStatus(bstrName, bstrID)

Parameters

expression

An expression that returns a NameCtrl Control object.

bstrName

Required String. Contains the sign-in name of the user (for example, someone@example.com).

bstrId

Required String. A string that identifies the HTML <DIV> tag to update with the correct pawn icon.

Return Value

A Long that indicates the online status, which can be one of the following values:

  • 0 - Online

  • 1 - Offline

  • 2 - Away

  • 3 - Busy

  • 4 - Be Right Back

  • 5 - On the Phone

  • 6 - Out to Lunch

Remarks

For every user on whom the GetStatus method is called, events are triggered when the online status of that person changes. The same bstrID value that is passed to this method is passed to an event handler.