IRTCClientPresence::Buddy
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
Note
This method is unsupported in Windows Embedded CE 6.0.
This method gets a buddy whose presentity Universal Resource Identifier (URI) matches the supplied URI.
For this method to succeed, the buddy must be present in the buddy list.
Syntax
HRESULT get_Buddy(
BSTR bstrPresentityURI,
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 method adds a reference to the Buddy object, which the caller is responsible for releasing.
Return Value
This method can return an RTC_E_ constant.
The following table shows an additional possible return value.
| Value | Meaning |
|---|---|
E_FAIL |
Method failed. This can mean that the buddy was not found. |
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
IRTCClientPresence
IRTCBuddy
IRTCClientPresence::Buddies
IRTCClientPresence::EnumerateBuddies
IRTCClientPresence::AddBuddy
IRTCClientPresence::RemoveBuddy