Método IDebugControl3::SetNextEventIndex (dbgeng.h)

Artículo
02/23/2024

El método SetNextEventIndex establece el siguiente evento para el destino actual seleccionando el evento de la lista estática de eventos para el destino, si existe dicha lista.

Sintaxis

HRESULT SetNextEventIndex(
  [in]  ULONG  Relation,
  [in]  ULONG  Value,
  [out] PULONG NextIndex
);

Parámetros

[in] Relation

Especifica cómo interpretar Value al establecer el índice del evento siguiente. Los valores posibles son: DEBUG_EINDEX_FROM_START, DEBUG_EINDEX_FROM_END y DEBUG_EINDEX_FROM_CURRENT.

[in] Value

Especifica el índice del evento siguiente en relación con el primer, último o evento actual. La interpretación de Value depende del valor de Relation, como se indica a continuación.

Valor de Relation	Índice de eventos siguiente
DEBUG_EINDEX_FROM_START	Valor.
DEBUG_EINDEX_FROM_END	Número de eventos menos Value.
DEBUG_EINDEX_FROM_CURRENT	Índice de eventos actual más Value.

El índice resultante debe ser mayor que cero y uno menor que el número de eventos devueltos por GetNumberEvents.

[out] NextIndex

Recibe el índice del evento siguiente. Si NextIndex 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

Si el evento especificado es el mismo que el evento actual, este método no hace nada. De lo contrario, este método establece el estado de ejecución del destino en DEBUG_STATUS_GO (y notifica las devoluciones de llamada de eventos). Cuando se llama a WaitForEvent , el motor generará el evento especificado para las devoluciones de llamada del evento y lo establecerá como el evento actual.

Este método solo es útil si el destino ofrece una lista de eventos.