IRTCBuddyGroup::Data (Windows CE 5.0)
This method sets or gets the private data associated with the group.
HRESULT put_Data( BSTRbstrData );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 Values
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
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCBuddyGroup | IRTCBuddyGroupEvent::StatusCode | RTC_EVENT | RTC_GROUP_EVENT_TYPE | SysFreeString
Send Feedback on this topic to the authors