Share via

IRTCBuddyGroup::Data (Windows Embedded CE 6.0)

  • Article

1/6/2010

Note

This method is unsupported in Windows Embedded CE 6.0.

This method sets or gets the private data associated with the group.

Syntax

HRESULT put_Data( 
  BSTR bstrData 
);
HRESULT get_Data( 
  BSTR* pbstrData 
);

Parameters

  • bstrData, pbstrData
    [in, out] Private data. On output, this parameter is a pointer to a BSTR that will be filled with the private data, 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 Value

This method can return an RTC_E_ constant. The following table shows additional possible return values.

Value Meaning

E_INVALIDARG

When setting data, the bstrData string is empty.

E_OUTOFMEMORY

When setting data, insufficient memory to perform this operation.

E_POINTER

The pbstrData parameter is not a valid pointer.

Remarks

If contact roaming is enabled, the put_Data method becomes an asynchronous function. If the return value fails, the operation fails. If the return is successful, the application must wait for the RTCE_GROUP event (defined in the RTC_EVENT enumeration) of type RTCGET_GROUP_UPDATE (defined in the RTC_GROUP_EVENT_TYPE enumeration). The result code can be obtained from the IRTCBuddyGroupEvent::StatusCode method.

Requirements

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

See Also

Reference

IRTCBuddyGroup
IRTCBuddyGroupEvent::StatusCode
RTC_EVENT
RTC_GROUP_EVENT_TYPE

Other Resources

SysFreeString