Partager via

IRTCPresenceDevice::GetPresenceData (Windows Embedded CE 6.0)

  • Article

1/6/2010

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