IRTCBuddyGroup::AddBuddy (Windows Embedded CE 6.0)

1/6/2010

This method adds an RTC buddy to the buddy group.

Syntax

HRESULT AddBuddy( 
  IRTCBuddy* pBuddy 
);

Parameters

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

Return Value

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

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

See Also

Reference

IRTCBuddyGroup
IRTCBuddy
IRTCBuddyGroup::RemoveBuddy
IRTCBuddyGroupEvent
IRTCBuddyGroupEvent::StatusCode
RTC_EVENT
RTC_GROUP_EVENT_TYPE