Share via

IRTCBuddy2::EnumeratePresenceDevices (Windows Embedded CE 6.0)

  • Article

1/6/2010

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