Share via

PRESENCE_PROPERTY

  • Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The fields of this enumeration type are used as indexes to specify the presence properties of a contact.

Syntax

typedef enum{
   PRESENCE_PROP_MSTATE = 0x0,
   PRESENCE_PROP_AVAILABILITY = 0x1,
   PRESENCE_PROP_IS_BLOCKED = 0x2,
   PRESENCE_PROP_PRESENCE_NOTE = 0x3,
   PRESENCE_PROP_IS_OOF = 0x4,
   PRESENCE_PROP_TOOL_TIP = 0x5,
   PRESENCE_PROP_CUSTOM_STATUS_STRING = 0x6,
   PRESENCE_PROP_DEVICE_TYPE = 0x7,
   PRESENCE_PROP_CURRENT_CALENDAR_STATE = 0x8
   PRESENCE_PROP_NEXT_CALENDAR_STATE = 0x9
   PRESENCE_PROP_NEXT_CALENDAR_STATE_TIME = 0xA
   PRESENCE_PROP_MAX = 0xB
} PRESENCE_PROPERTY;

Members

  • PRESENCE_PROP_MSTATE
    Specifies the computer state of a contact.
  • PRESENCE_PROP_AVAILABILITY
    Specifies the presence state of a contact. The property value is of the int type.
  • PRESENCE_PROP_IS_BLOCKED
    Specifies the blocked status of a contact. The property value is of the Boolean type.
  • PRESENCE_PROP_PRESENCE_NOTE
    Specifies the presence note of a contact. The property value is of the String type.
  • PRESENCE_PROP_IS_OOF
    Specifies the OOF message of a contact. The property value is of the String type.
  • PRESENCE_PROP_TOOL_TIP
    Specifies the ToolTip texts. The property value is of the string type.
  • PRESENCE_PROP_CUSTOM_STATUS_STRING
    Specifies the custom status string of a contact. The property value is of the String type.
  • PRESENCE_PROP_DEVICE_TYPE
    Specifies the device type used by a contact. (Not used.)
  • PRESENCE_PROP_CURRENT_CALENDAR_STATE
    Specifies the current calendar state. The property value is an enum of the CALENDAR_STATE type
  • PRESENCE_PROP_NEXT_CALENDAR_STATE
    Specifies the next calendar state The property value is an enum of the CALENDAR_STATE type
  • PRESENCE_PROP_NEXT_CALENDAR_STATE_TIME
    Specifies the time when the next calendar will start. The property value is of the variant time (Double) type
  • PRESENCE_PROP_MAX
    The maximum number of presence properties of a contact. The property value is of the int type.

Remarks

When retrieving presence properties using the IMessengerContactAdvanced::PresenceProperties method, individual elements of the resultant property arrays can be accessed with the help of the fields defined in this enumeration type. The following code shows an example.

IMessengerContact contact = ...;

IMessengerContactAdvanced contactAdv = contact as IMessengerContactAdvanced;
object[] properties =contactAdv.PresenceProperties as object[];
int availability = (int)properties[PRESENCE_PROP_AVAILABILITY];

Requirements

  • Client
    Requires Microsoft DirectX 9.0, C Runtime libraries (msvcm80.dll) on Microsoft Windows© Vista, Microsoft Windows XP Service Pack 1 (SP1) or later, or Microsoft Windows 2000 with Service Pack 4 (SP4). Any Communicator-imposed restrictions apply. .
  • Server
    Requires Microsoft Office Communications Server 2007, AV MCU (for Media Support), Media Relay (for NAT/Firewall traversal) on Microsoft Office Communications Server 2007.
  • Product
    Microsoft Office Communicator 2007 Automation API
  • IDL file
    Msgrua.idl

See Also

Reference

Enums