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

Artigo
02/26/2024

O método SetNextEventIndex define o próximo evento para o destino atual selecionando o evento na lista estática de eventos para o destino, se essa lista existir.

Sintaxe

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

Parâmetros

[in] Relation

Especifica como interpretar Value ao definir o índice do próximo evento. Os valores possíveis são: DEBUG_EINDEX_FROM_START, DEBUG_EINDEX_FROM_END e DEBUG_EINDEX_FROM_CURRENT.

[in] Value

Especifica o índice do próximo evento relativo ao primeiro, último ou atual evento. A interpretação de Value depende do valor de Relation, da seguinte maneira.

Valor da Relação	Índice do Próximo Evento
DEBUG_EINDEX_FROM_START	Valor.
DEBUG_EINDEX_FROM_END	Número de eventos menos Valor.
DEBUG_EINDEX_FROM_CURRENT	O índice de evento atual mais Valor.

O índice resultante deve ser maior que zero e um menor que o número de eventos retornados por GetNumberEvents.

[out] NextIndex

Recebe o índice do próximo evento. Se NextIndex for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Se o evento especificado for o mesmo que o evento atual, esse método não fará nada. Caso contrário, esse método define a status de execução do destino como DEBUG_STATUS_GO (e notifica os retornos de chamada do evento). Quando WaitForEvent for chamado, o mecanismo gerará o evento especificado para os retornos de chamada de evento e o definirá como o evento atual.

Esse método só será útil se o destino oferecer uma lista de eventos.