GetPresenceData

The GetPresenceData method returns the enhanced presence information including the namespace and data for the specified device. The presence data contains application-specific information that is included in the presence document. The presence data is set in the IRTCClientPresence2::SetPresenceData method.

HRESULT GetPresenceData(BSTR* pbstrNamespace,BSTR* pbstrData);

Parameters

  • pbstrNamespace
    Pointer to a BSTR containing the namespace.
  • pbstrData
    Pointer to a BSTR containing the enhanced presence data.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_NOT_EXIST The namespace or the data does not exist.
E_OUTOFMEMORY Insufficient memory to perform this operation.
E_POINTER The pbstrNamespace or pbstrData parameter is not a valid pointer.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCPresenceDevice is defined as BC6A90DD-AD9A-48da-9B0C-2515E38521AD.

See Also

IRTCPresenceDevice, IRTCEnumPresenceDevices, Presence, Retrieve Presence Information