IRTCClientPresence::EnumerateWatchers

  • Article

The EnumerateWatchers method returns an enumeration of the allowed and blocked Watchers available on this Client. If there are no Watchers on this Client, an empty enumeration is returned. This method is intended for C and C++ applications. Visual Basic applications should use the get_Watchers method.

HRESULT EnumerateWatchers(IRTCEnumWatchers**ppEnum);

Parameters

  • ppEnum
    [out] Pointer to the IRTCEnumWatchers interface on an enumeration object containing an IRTCWatcher pointer for each Watcher on this Client. This call adds a reference to the enumeration object, which the caller is responsible for releasing.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
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, IRTCClientPresence::get_Watchers, IRTCEnumWatchers, IRTCWatcher