Share via


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