IRTCBuddyGroup::AddBuddy (Windows CE 5.0)

Send Feedback

This method adds an RTC buddy to the buddy group.

HRESULT AddBuddy( IRTCBuddy*pBuddy );

Parameters

  • pBuddy
    [in] Pointer to the IRTCBuddy interface of the buddy to add.

Return Values

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

Value Meaning
E_POINTER The pBuddy parameter is not a valid pointer.

Remarks

This method triggers the RTCE_GROUP event (defined in the RTC_EVENT enumeration), which returns an IRTCBuddyGroupEvent interface.

If contact roaming is enabled, the AddBuddy 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_BUDDY_ADD (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 | IRTCBuddy | IRTCBuddyGroup::RemoveBuddy | IRTCBuddyGroupEvent | IRTCBuddyGroupEvent::StatusCode | RTC_EVENT | RTC_GROUP_EVENT_TYPE

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.