Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The put_Data property sets the private data of the group. The data set in this method is retrieved by IRTCBuddyGroup::get_Data.
HRESULT put_Data(BSTRbstrData);
Parameters
- bstrData
[in] The data to be set.
Return Values
RTC methods may return an RTC_E_ constant.
| Value | Meaning |
|---|---|
| RTC_E_CLIENT_NOT_INITIALIZED | The client object is not initialized. |
| RTC_E_PRESENCE_NOT_ENABLED | Presence has not been enabled. |
| E_INVALIDARG | The bstrData string is empty. |
| E_OUTOFMEMORY | Insufficient memory to perform this operation |
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 of type RTCGET_GROUP_UPDATE. The result code can be obtained from the IRTCBuddyGroupEvent::get_StatusCode method.
Requirements
Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCBuddyGroup is defined as 60361E68-9164-4389-A4C6-D0B3925BDA5E.
See Also
IRTCBuddyGroup, IRTCBuddy, IRTCBuddy2, IRTCBuddyGroup::get_Data