Método IDebugControl3::SetNextEventIndex (dbgeng.h)
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 valor 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 | Siguiente índice de eventos |
|---|---|
| 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 siguiente evento. 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 información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
Observaciones
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.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |