IRTCClientPresence2::PresenceProperty (Windows CE 5.0)

  • 發行項

Send Feedback

This method sets or gets the standard presence property for the local user.

This information is included in the presence document.

This method sets information that can be retrieved by the IRTCBuddy2::PresenceProperty and IRTCPresenceDevice::PresenceProperty methods.

HRESULT put_PresenceProperty(RTC_PRESENCE_PROPERTYenProperty,BSTRbstrProperty);HRESULT get_PresenceProperty(RTC_PRESENCE_PROPERTYenProperty,BSTR*pbstrProperty);

Parameters

  • enProperty
    [in] An RTC_PRESENCE_PROPERTY enumeration value specifying the type of presence property.

  • bstrProperty, pbstrProperty
    [in, out] The presence property of the local user.

    On output, this parameter is a pointer to a BSTR that will be filled with the presence property of the local user, or an empty string if there is no entry.

    The method allocates the buffer. The caller is responsible for releasing this memory with SysFreeString.

Return Values

This method can return an RTC_E_ constant.

The following table shows additional possible return values.

Value Meaning
E_INVALIDARG The size of the bstrProperty parameter is too large.

This parameter is limited to the following sizes based on the value in the enProperty parameter:

  • RTCPP_PHONENUMBER: 127 characters
  • RTCPP_DISPLAYNAME: 1,023 characters
  • RTCPP_EMAIL: 1,023 characters
  • RTC_DEVICE_NAME: 255 characters
E_OUTOFMEMORY Insufficient memory to perform this operation.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

IRTCClientPresence2 | IRTCBuddy2::PresenceProperty | IRTCPresenceDevice::PresenceProperty | RTC_PRESENCE_PROPERTY | SysFreeString

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.