SetExceptionFilterSecondCommand

The SetExceptionFilterSecondCommand and SetExceptionFilterSecondCommandWide methods set the command that will be executed by the debugger engine on the second chance of a specified exception.

HRESULT
  IDebugControl::SetExceptionFilterSecondCommand(
    IN ULONG  Index,
    IN PCSTR  Command
    );

HRESULT
  IDebugControl3::SetExceptionFilterSecondCommandWide(
    IN ULONG  Index,
    IN PCWSTR  Command
    );

#ifdef UNICODE
#define SetExceptionFilterSecondCommandT SetExceptionFilterSecondCommandWide
#else
#define SetExceptionFilterSecondCommandT SetExceptionFilterSecondCommand
#endif

Parameters

Index

Specifies the index of the exception filter whose second-chance command will be set. Index must not refer to the specific event filters as these are not exception filters and only exception events get a second chance. If Index refers to the default exception filter, the second-chance command is set for all exceptions that do not have an exception filter.

Command

Receives the second-chance command for the exception filter.

Return Value

S_OK

The method was successful.

This method may also return error values. See Return Values for more details.

Interface Version

SetExceptionFilterSecondCommand is available in all versions of IDebugControl. SetExceptionFilterSecondCommandWide is available in IDebugControl3 and later versions.

Comments

For more information about event filters, see Event Filters.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

sx, sxd, sxe, sxi, sxn (Set Exceptions), GetExceptionFilterSecondCommand, SetEventFilterCommand