Método IDebugControl::GetExceptionFilterSecondCommand (dbgeng.h)

Artículo
02/26/2024

El método GetExceptionFilterSecondCommand devuelve el comando que ejecutará el motor del depurador tras la segunda oportunidad de una excepción especificada.

Sintaxis

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

Parámetros

[in] Index

Especifica el índice del filtro de excepción cuyo comando de segunda oportunidad se devolverá. El índice también puede hacer referencia al filtro de excepción predeterminado para devolver el comando de segunda oportunidad para esas excepciones que no tienen un filtro de excepción específico o arbitrario.

[out, optional] Buffer

Recibe el comando de segunda oportunidad para el filtro de excepción.

[in] BufferSize

Especifica el tamaño, en caracteres, del búfer que especifica Buffer . Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] CommandSize

Recibe el tamaño, en caracteres, del comando de segunda oportunidad para el filtro de excepción. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si CommandSize es NULL, no se devuelve esta información.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Solo los filtros de excepción admiten un comando de segunda oportunidad. Si Index hace referencia a un filtro de eventos específico, el comando devuelto a Buffer estará vacío. El comando devuelto también estará vacío si no se ha establecido ningún comando de segunda oportunidad para la excepción especificada.

Para obtener más información sobre los filtros de eventos, vea Filtros de eventos.