IOsAxsExec::SingleStepInCurThread (Windows Embedded CE 6.0)

1/5/2010

This method commands a debugging target to execute a single instruction in the current thread and then halt.

Syntax

HRESULT SingleStepInCurThread(
  BOOL fIgnoreCurrentExcept,
  BOOL fOneCycleOnly
);

fIgnoreCurrentExcept
[in] If TRUE, this flag causes a hardware probe to ignore exceptions that occur at the current location.

The debugger uses this flag to pass an exception to the OS or to operate in a "Go unhandled" mode.

fOneCycleOnly
[in] If TRUE this Boolean value causes execution to proceed for a single step of one clock cycle.

If FALSE, execution proceeds for a single step of one entire instruction.

The following table shows the return values for this method.

Value	Description
S_OK	Indicates the function was successful.
E_FAIL	Indicates an unspecified failure.
E_INVALIDARG	Indicates one or more invalid arguments.
EXDI_E_COMMUNICATION	Indicates a communication error between the host driver and the debugging target.
EXDI_E_TGTWASNOTHALTED	Indicates the target was not halted.
EXDI_E_NORESAVAILABLE	Indicates no resource is available to do a single step.