Share via


IRTCClientPresence::get_Watcher

The get_Watcher property gets an IRTCWatcher interface for a Watcher whose presentity URI matches the URI given as a parameter. For the function to succeed, the Watcher must be present in the allowed/blocked Watchers list.

HRESULT get_Watcher(BSTRbstrPresentityURI,
IRTCWatcher**ppWatcher);

Parameters

  • bstrPresentityURI
    [in] The presentity URI of the Watcher, with or without the sip: namespace prefix.
  • ppWatcher
    [out] Pointer to the IRTCWatcher interface. This call adds a reference to the interface, which the caller is responsible for releasing.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
E_FAIL Method failed. This may mean that the watcher was not found.
RTC_E_CLIENT_NOT_INITIALIZED The client is not initialized.
RTC_E_PRESENCE_NOT_ENABLED Presence is not enabled.

Requirements

Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClientPresence is defined as 11c3cbcc-0744-42d1-968a-51aa1bb274c6.

See Also

IRTCClientPresence, IRTCWatcher