IDebugControl3::SetNextEventIndex 메서드(dbgeng.h)

아티클
02/23/2024

SetNextEventIndex 메서드는 해당 목록이 있는 경우 대상에 대한 정적 이벤트 목록에서 이벤트를 선택하여 현재 대상에 대한 다음 이벤트를 설정합니다.

구문

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

매개 변수

[in] Relation

다음 이벤트의 인덱스를 설정할 때 Value 를 해석하는 방법을 지정합니다. 가능한 값은 DEBUG_EINDEX_FROM_START, DEBUG_EINDEX_FROM_END 및 DEBUG_EINDEX_FROM_CURRENT.

[in] Value

첫 번째, 마지막 또는 현재 이벤트를 기준으로 다음 이벤트의 인덱스를 지정합니다. Value의 해석은 다음과 같이 Relation 값에 따라 달라집니다.

관계 값	다음 이벤트 인덱스
DEBUG_EINDEX_FROM_START	값.
DEBUG_EINDEX_FROM_END	이벤트 수에서 값을 뺀 값입니다.
DEBUG_EINDEX_FROM_CURRENT	현재 이벤트 인덱스 및 값입니다.

결과 인덱스는 0보다 크고 GetNumberEvents에서 반환된 이벤트 수보다 1보다 작아야 합니다.

[out] NextIndex

다음 이벤트의 인덱스를 받습니다. NextIndex가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요.

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.

설명

지정된 이벤트가 현재 이벤트와 같으면 이 메서드는 아무 것도 수행하지 않습니다. 그렇지 않으면 이 메서드는 대상의 실행 상태 DEBUG_STATUS_GO 설정(이벤트 콜백에 알림)합니다. WaitForEvent가 호출되면 엔진은 이벤트 콜백에 대해 지정된 이벤트를 생성하고 현재 이벤트로 설정합니다.

이 메서드는 대상이 이벤트 목록을 제공하는 경우에만 유용합니다.