IRTCBuddy2::EnumeratePresenceDevices
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 retrieves an enumerated list of the available presence devices. This method is intended for C and C++ applications.
Syntax
HRESULT EnumeratePresenceDevices(
IRTCEnumPresenceDevices** ppEnumDevices
);
Parameters
- ppEnumDevices
[out] Pointer to an IRTCEnumPresenceDevices interface on an enumeration object containing an IRTCPresenceDevice pointer for each presence device available for this buddy. This method adds a reference to the enumeration object, which the caller is responsible for releasing.
Return Value
This method can return an RTC_E_ constant. The following table shows additional possible return values.
| Value | Meaning |
|---|---|
E_FAIL |
The ppEnumDevices parameter is not a valid pointer. |
E_OUTOFMEMORY |
Insufficient memory to perform this operation. |
Remarks
Every time an IRTClient gets a presence update of an IRTCBuddy, it deletes all previous IRTCPresenceDevice objects from the buddy’s internal array and then creates new objects with the updated presence.
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |
See Also
Reference
IRTCBuddy2
IRTCBuddy2::PresenceDevices
IRTCEnumPresenceDevices
IRTCPresenceDevice