IRTCPresenceDevice::GetPresenceData

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

Note

This method is unsupported in Windows Embedded CE 6.0.

This method retrieves the presence data for this device. The presence data contains application-specific information that is included in the presence document. An application sets presence data using IRTCClientPresence2::SetPresenceData.

Syntax

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

Parameters

• pbstrNamespace
  [out] Pointer to a BSTR that will be filled with the namespace, or an empty string if there is no entry. The method is responsible for allocating the buffer. The application is responsible for releasing this memory with SysFreeString.

• pbstrData
  [out] Pointer to a BSTR that will be filled with the enhanced presence data, or an empty string if there is no entry. The method is responsible for allocating the buffer. The application is responsible for releasing this memory with SysFreeString.

Return Value

This method can return an RTC_E_ constant. The following table shows additional return values and additional information about a specific return value.

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

Requirements

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

See Also

Reference

IRTCPresenceDevice
IRTCClientPresence2::SetPresenceData

Other Resources

SysFreeString