IRTCClientPresence::get_Buddy
The get_Buddy property gets an IRTCBuddy interface for a Buddy whose presentity URI matches the URI given as a parameter. For the function to succeed, the Buddy must be present in the list of buddies.
HRESULT get_Buddy(BSTRbstrPresentityURI,
IRTCBuddy**ppBuddy);
Parameters
- bstrPresentityURI
[in] The presentity URI of the Buddy, with or without the sip:' namespace prefix. - ppBuddy
[out] Pointer to the IRTCBuddy interface. This call also adds a reference to the interface, which the caller is responsible for releasing.
Return Values
RTC methods may return an RTC_E_ constant.
Value | Meaning |
---|---|
E_FAIL | Method failed. This may mean that the buddy was not found. |
RTC_E_CLIENT_NOT_INITIALIZED | The client is not initialized. |
RTC_E_PRESENCE_NOT_ENABLED | Presence is not enabled. |
Requirements
Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClientPresence is defined as 11c3cbcc-0744-42d1-968a-51aa1bb274c6.
See Also
IRTCClientPresence, IRTCBuddy, IRTCClientPresence::get_Buddies, IRTCClientPresence::EnumerateBuddies, IRTCClientPresence::AddBuddy, IRTCClientPresence::RemoveBuddy, Create a Buddy Group and Add Buddies