Expand Minimize

IDebugControl::GetExceptionFilterSecondCommand method

The GetExceptionFilterSecondCommand method returns the command that will be executed by the debugger engine upon the second chance of a specified exception.

Syntax


HRESULT GetExceptionFilterSecondCommand(
  [in]             ULONG Index,
  [out, optional]  PSTR Buffer,
  [in]             ULONG BufferSize,
  [out, optional]  PULONG CommandSize
);

Parameters

Index [in]

Specifies the index of the exception filter whose second-chance command will be returned. Index can also refer to the default exception filter to return the second-chance command for those exceptions that do not have a specific or arbitrary exception filter.

Buffer [out, optional]

Receives the second-chance command for the exception filter.

BufferSize [in]

Specifies the size, in characters, of the buffer that Buffer specifies.

CommandSize [out, optional]

Receives the size, in characters, of the second-chance command for the exception filter. If CommandSize is NULL, this information is not returned.

Return value

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

Return codeDescription
S_OK

The method was successful.

 

Remarks

Only exception filters support a second-chance command. If Index refers to a specific event filter, the command returned to Buffer will be empty. The returned command will also be empty if no second-chance command has been set for the specified exception.

For more information about event filters, see Event Filters.

Requirements

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugControl
IDebugControl2
IDebugControl3
sx, sxd, sxe, sxi, sxn (Set Exceptions)
SetExceptionFilterSecondCommand
GetEventFilterCommand

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft