IEndpoint.BeginSubscribePresence Method
Begins an asynchronous request to subscribe to presence notifications for one or more contacts that are not in the user's contact list.
Namespace: Microsoft.Exchange.InstantMessaging
Assembly: Microsoft.Exchange.InstantMessaging (in Microsoft.Exchange.InstantMessaging.dll)
Syntax
'Declaration
Function BeginSubscribePresence ( _
uris As String(), _
userCallback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Usage
Dim instance As IEndpoint
Dim uris As String()
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginSubscribePresence(uris, _
userCallback, state)
IAsyncResult BeginSubscribePresence(
string[] uris,
AsyncCallback userCallback,
Object state
)
Parameters
- uris
Type: []
An array of Session Initiation Protocol (SIP) URIs that identify the user's whose presence information should be subscribed.
- userCallback
Type: System.AsyncCallback
The System.AsyncCallback delegate that is called when the operation is complete. The callback handler is responsible for calling the EndSubscribePresence(IAsyncResult) method.
- state
Type: System.Object
Contains user state information for the requested operation.
Return Value
Type: System.IAsyncResult
An System.IAsyncResult object that references the asynchronous request.
Remarks
By default the user will receive presence information for the contacts in the user's contacts list. The BeginSubscribePresence([], AsyncCallback, Object) method enables the user to subscribe to presence information for user's not in the default contact list. The subscriptions created by this method will remain in effect until either the EndSignOut(IAsyncResult) or EndUnsubscribePresence(IAsyncResult) methods complete successfully.
See Also