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

GetNumberEvents 메서드는 이벤트 수가 고정된 경우 현재 대상에 대한 이벤트 수를 반환합니다.

구문

HRESULT GetNumberEvents(
  [out] PULONG Events
);

[out] Events

대상에 저장된 이벤트 수를 받습니다. 대상이 여러 이벤트를 제공하는 경우 이벤트는 사용 가능한 이벤트 수로 설정됩니다. 그렇지 않으면 이벤트가 하나로 설정됩니다.

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

반환 코드	Description
S_OK	메서드가 성공했으며 이벤트에 는 대상에 대해 가능한 총 이벤트 수가 포함됩니다.
S_FALSE	메서드가 성공했지만 이벤트에 는 현재 시간에 가능한 총 이벤트 수만 포함됩니다. 변수 실행을 지원하는 대상에는 대상 실행 중에 서로 다른 지점에서 사용할 수 있는 다양한 이벤트 집합이 있을 수 있습니다.

크래시 덤프 파일에는 이벤트의 정적 목록이 포함됩니다. 각 이벤트는 특정 시점에 대상의 스냅샷 나타냅니다. 현재 대상이 크래시 덤프 파일인 경우 이 메서드는 이벤트를 저장된 이벤트 수로 설정하고 S_OK 반환합니다.

라이브 대상은 이벤트를 동적으로 생성하며 알려진 이벤트 집합이 반드시 있는 것은 아닙니다. 현재 대상이 제한되지 않은 이벤트 수가 있는 라이브 대상인 경우 이 메서드는 이벤트를 현재 사용 가능한 이벤트 수로 설정하고 S_FALSE 반환합니다.

자세한 내용은 이벤트 정보 항목을 참조하세요.

요구 사항	값
대상 플랫폼	데스크톱
머리글	dbgeng.h(Dbgeng.h 포함)