IeXdiEnumCodeBreakpoint::Next

  • Article

This method retrieves pointers for the next set of code breakpoint objects in the list.

HRESULT Next(
  DWORD celt, 
  IeXdiCodeBreakpoint* apieXdiCodeBreakpoint[],
  DWORD* pceltFetched
);

Parameters

  • celt
    [in] Requests number of code breakpoint object-pointers to be returned.
  • apieXdiCodeBreakpoint
    [out, size_is(celt), length_is(*pceltFetched)] Returns the interface pointers for code breakpoint objects.
  • pceltFetched
    [out] Returns the actual number of pointers returned in rgelt.

Return Values

This method has the following return values.

Return value Description
S_OK Function is successful.
EXDI_E_NOTIMPL Not implemented.
EXDI_E_OUTOFMEMORY Failed to allocate necessary memory.
EXDI_E_INVALIDARG One or more arguments are invalid.
EXDI_E_ABORT Operation aborted.
EXDI_E_FAIL Unspecified failure occurred.
EXDI_E_COMMUNICATION Communication error occurred between host driver and target.
EXDI_E_CANNOTWHILETGTRUNNING Cannot proceed while target is running. Must halt the target first.

Remarks

The client must declare an array of pointers to IeXdiCodeBreakpoint or IeXdiDataBreakpoint, whichever applies. The client then should call this method, passing the size of the array, a pointer to the start of the array itself, and a pointer to a DWORD that will contain how many breakpoints were actually enumerated.

The client is responsible for calling Release on every breakpoint that is returned in IeXdiCodeBreakpoint.

The Release function increments the internal count in the enumeration by pceltFetched. For instance, if ten breakpoints were enumerated, and the client called Next to get the first three breakpoints, a subsequent call to Next would get breakpoints 4, 5, and 6, and so on. This function also works in conjunction with GetNext, which only gets one element and increments the enumeration by one, and Reset, which resets the enumeration.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: exdi.idl.

See Also

IeXdiEnumCodeBreakpoint

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.