LocalEndpointPresenceServices.BeginPresenceQuery Method

Begins a presence query request for a given list of targets for the given set of presence categories.

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

Syntax

'Declaration
Public Function BeginPresenceQuery ( _
    targets As IEnumerable(Of String), _
    categories As String(), _
    queryResultHandler As EventHandler(Of RemotePresentitiesNotificationEventArgs), _
    userCallback As AsyncCallback, _
    state As Object _
) As IAsyncResult
'Usage
Dim instance As LocalEndpointPresenceServices
Dim targets As IEnumerable(Of String)
Dim categories As String()
Dim queryResultHandler As EventHandler(Of RemotePresentitiesNotificationEventArgs)
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginPresenceQuery(targets, _
    categories, queryResultHandler, _
    userCallback, state)

public IAsyncResult BeginPresenceQuery(
    IEnumerable<string> targets,
    string[] categories,
    EventHandler<RemotePresentitiesNotificationEventArgs> queryResultHandler,
    AsyncCallback userCallback,
    Object state
)

Parameters

• targets
  Type: System.Collections.Generic.IEnumerable<String>
  The list of target addresses for the query.

• categories
  Type: []
  The list of presence categories for the query. Categories that can be set are "contactCard", "note", "state", "services", and "calendarData".

• queryResultHandler
  Type: System.EventHandler<RemotePresentitiesNotificationEventArgs>
  EventHandler to be invoked as results become available. This value can be null.

• userCallback
  Type: System.AsyncCallback
  The method to be called when the asynchronous operation is completed. This value can be null.

• state
  Type: System.Object
  A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.

Return Value

Type: System.IAsyncResult
An IAsyncResult that references the asynchronous operation.

Exceptions

Remarks

A presence query internally can involve multiple query requests to different single and pool targets. If the user specified a query result handler, then results will be notified on the given event handler as soon as they are available. Calling EndPresenceQuery will return all results for the query.

See Also

Reference

LocalEndpointPresenceServices Class

LocalEndpointPresenceServices Members

Microsoft.Rtc.Collaboration Namespace