IDebugControl4::GetExceptionFilterSecondCommand method (dbgeng.h)
The GetExceptionFilterSecondCommandWide 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
[in] Index
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.
[out, optional] Buffer
Receives the second-chance command for the exception filter.
[in] BufferSize
Specifies the size, in characters, of the buffer that Buffer specifies. This size includes the space for the '\0' terminating character.
[out, optional] CommandSize
Receives the size, in characters, of the second-chance command for the exception filter. This size includes the space for the '\0' terminating character. 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 code | Description |
|---|---|
|
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
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | dbgeng.h (include Dbgeng.h) |