RTC_BUDDY_EVENT_TYPE

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This enumeration defines possible buddy events. The IRTCBuddyEvent2::EventType method uses this enumeration. This enumeration is available only for RTC 1.2 and later.

Syntax

typedef enum RTC_BUDDY_EVENT_TYPE { 
  RTCBET_BUDDY_ADD, 
  RTCBET_BUDDY_REMOVE, 
  RTCBET_BUDDY_UPDATE, 
  RTCBET_BUDDY_STATE_CHANGE,
  RTCBET_BUDDY_ROAMED,
  RTCBET_BUDDY_SUBSCRIBED 
} RTC_BUDDY_EVENT_TYPE;

Elements

• RTCBET_BUDDY_ADD
  This buddy has been successfully added to the list of buddies.

• RTCBET_BUDDY_REMOVE
  This buddy has been successfully removed from the list of buddies.

• RTCBET_BUDDY_UPDATE
  This buddy's properties have been updated.

• RTCBET_BUDDY_STATE_CHANGE
  This buddy's presence state has changed. This event will not be fired for a buddy of type RTCBT_ALWAYS_ONLINE or RTCBT_ALWAYS_OFFLINE. For information, see RTC_BUDDY_SUBSCRIPTION_TYPE.

• RTCBET_BUDDY_ROAMED
  This event is fired when a buddy from the locally persisted list of buddies is stored on the SIP server. If the application attempts to add a buddy when the buddy roaming session was not previously enabled, the buddy is added to the list of buddies persisted on the local machine and saved to the SIP server when the buddy roaming session is enabled. When the buddy has been successfully saved on the server, an IRTCBuddyEvent is fired to notify the application of the roamed buddy.

  This enumeration value is only available for RTC 1.2 and later.

• RTCBET_BUDDY_SUBSCRIBED
  This buddy's presence information is subscribed to. This event indicates that a SIP SUBSCRIBE message has been sent to the buddy. This event will not be fired for a buddy of type RTCBT_ALWAYS_ONLINE or RTCBT_ALWAYS_OFFLINE.

  This enumeration value is only available for RTC 1.2 and later.

Requirements

See Also

Reference

RTC Client API Enumerations
IRTCBuddyEvent
IRTCBuddyEvent2::EventType
RTC_BUDDY_SUBSCRIPTION_TYPE