Share via

IRTCBuddyGroup::put_Name

  • Article

The put_Name property sets the name of the group. The data set in this method is retrieved by IRTCBuddyGroup::get_Name.

HRESULT put_Name(BSTRbstrName);

Parameters

  • bstrName
    [in] Contains the name 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_OUTOFMEMORY Insufficient memory to perform this operation.
E_INVALIDARG The bstrName parameter is an empty string.

Remarks

If contact roaming is enabled, the put_Name 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_Name