IRTCClientPresence2::WatcherEx (Windows Embedded CE 6.0)

1/6/2010

Note

This method is unsupported in Windows Embedded CE 6.0.

This method gets a watcher attached to the RTC client object, based on a supplied SIP URI.

Syntax

HRESULT get_WatcherEx( 
  RTC_WATCHER_MATCH_MODE enMode, 
  BSTR bstrPresentityURI, 
  IRTCWatcher2** ppWatcher 
);

Parameters

• enMode
  [in] RTC_WATCHER_MATCH_MODE enumeration value describing the URI match level to use when searching for the watcher.

• bstrPresentityURI
  [in] The SIP URI. The prefix sip: is not necessary for matching.

• ppWatcher
  [out] Pointer to an IRTCWatcher2 interface.

  This parameter can be NULL, indicating that a matching watcher could not be found.

  This method adds a reference to the Watcher object, which the caller is responsible for releasing.

Return Value

This method can return an RTC_E_ constant.

The following table shows an additional possible return value.

Value	Meaning
E_POINTER	The ppWatcher parameter is not a valid pointer.

Requirements

Header	rtccore.h, rtccore.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

IRTCClientPresence2
IRTCWatcher2
IRTCClientPresence2::AddWatcherEx
RTC_WATCHER_MATCH_MODE