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.

Copy Code
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