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

아티클
08/07/2023

GetLastEventInformation 메서드는 대상에서 발생한 마지막 이벤트에 대한 정보를 반환합니다.

구문

HRESULT GetLastEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PSTR   Description,
  [in]            ULONG  DescriptionSize,
  [out, optional] PULONG DescriptionUsed
);

매개 변수

[out] Type

대상에 의해 생성된 마지막 이벤트의 형식을 받습니다. 가능한 형식 목록은 DEBUG_EVENT_XXX 참조하세요.

[out] ProcessId

이벤트가 발생한 프로세스의 프로세스 ID를 받습니다. 이 정보를 사용할 수 없는 경우 DEBUG_ANY_ID 대신 반환됩니다.

[out] ThreadId

마지막 이벤트가 발생한 스레드의 스레드 인덱스(스레드 ID가 아님)를 받습니다. 이 정보를 사용할 수 없는 경우 DEBUG_ANY_ID 대신 반환됩니다.

[out, optional] ExtraInformation

이벤트에 대한 추가 정보를 받습니다. 이 추가 정보의 내용은 이벤트 유형에 따라 달라집니다. ExtraInformation이 NULL이면 이 정보가 반환되지 않습니다.

[in] ExtraInformationSize

ExtraInformation에서 지정하는 버퍼의 크기(바이트)를 지정합니다.

[out, optional] ExtraInformationUsed

추가 정보의 크기(바이트)를 받습니다. ExtraInformationUsed가 NULL이면 이 정보가 반환되지 않습니다.

[out, optional] Description

이벤트에 대한 설명을 받습니다. Description이 NULL이면 이 정보가 반환되지 않습니다.

[in] DescriptionSize

Description에서 지정하는 버퍼의 크기를 문자 단위로 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] DescriptionUsed

이벤트에 대한 설명의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. DescriptionUsed가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 ExtraInformationSize 또는 DescriptionSize 는 해당 데이터 또는 문자열의 크기가 작아지고 데이터 또는 문자열이 버퍼 내부에 맞게 잘렸습니다.