ContactGroupServices Class

ContactGroupServices class contains services to add, delete, or update the contacts and groups of the session's owner.

Inheritance Hierarchy

System.Object
  Microsoft.Rtc.Collaboration.Presence.PublishSubscribeSession
    Microsoft.Rtc.Collaboration.ContactsGroups.ContactGroupServices

Namespace:  Microsoft.Rtc.Collaboration.ContactsGroups
Assembly:  Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)

Syntax

'Declaration
Public Class ContactGroupServices _
    Inherits PublishSubscribeSession
'Usage
Dim instance As ContactGroupServices
public class ContactGroupServices : PublishSubscribeSession

Remarks

Contacts are unified communication entities identifiable by SIP URIs that can be assembled into logical collections called groups. A Group is identified by a group ID which is a server-assigned integer. A Contact can belong to zero or more groups. Adding someone to the contact list does not automatically indicate that their presence information is subscribed to. The application must separately use the RemotePresence class to subscribe to these contacts. Groups do not hold references to their contained contacts.

This feature is available only to the UserEndpoint class and not to an ApplicationEndpoint.

These contacts and groups are cached locally when BeginSubscribe(AsyncCallback, Object) is invoked and are cleared if they have not been accessed for longer than five minutes. Subsequent usage of the APIs in this class causes the cache to be populated again.

The allowed operations are adding, deleting, and updating of contact and group properties. When a group is deleted, the group is automatically removed from all contacts belonging to that group.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

ContactGroupServices Members

Microsoft.Rtc.Collaboration.ContactsGroups Namespace

UserEndpoint

Contact

Group

ContactGroupNotificationEventArgs