IRTCEnumPresenceDevices::Next
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 the next specified number of elements in the enumeration sequence.
Syntax
HRESULT Next(
ULONG celt,
IRTCPresenceDevice** ppElements,
ULONG* pceltFetched
);
Parameters
- celt
[in] Number of elements to fetch.
ppElements
[out] Pointer to an array of IRTCPresenceDevice pointers. This buffer must be large enough to hold celt pointers. The call overwrites the current values in the first celt items of the array.If the method succeeds, an object is created for each retrieved interface pointer. The caller must free these objects using Release when they are no longer being used.
- pceltFetched
[in, out] Pointer to the number of elements actually fetched by the enumerator, or NULL if celt is 1. When the method returns, the array contains pceltFetched valid pointers. The caller is responsible for releasing this memory. If celt is greater than pceltFetched , the rest of array contains NULL.
Return Value
This method can return an RTC_E_ constant. The following table shows additional possible return values.
| Value | Description |
|---|---|
S_FALSE |
Some elements were fetched, but the total number is less than the specified number in celt parameter. The pceltFetched parameter contains the actual number of elements fetched. |
S_OK |
Specified number of elements were fetched. |
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |
See Also
Reference
IRTCEnumPresenceDevices
IRTCPresenceDevice