Método IDebugControl2::GetLastEventInformation (dbgeng.h)

Artigo
02/06/2025

O método GetLastEventInformation retorna informações sobre o último evento que ocorreu em um destino.

Sintaxe

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
);

Parâmetros

[out] Type

Recebe o tipo do último evento gerado pelo destino. Para obter uma lista de tipos possíveis, consulte DEBUG_EVENT_XXX.

[out] ProcessId

Recebe a ID do processo no qual o evento ocorreu. Se essas informações não estiverem disponíveis, DEBUG_ANY_ID será retornado.

[out] ThreadId

Recebe o índice de thread (não a ID do thread) do thread no qual o último evento ocorreu. Se essas informações não estiverem disponíveis, DEBUG_ANY_ID será retornado.

[out, optional] ExtraInformation

Recebe informações extras sobre o evento. O conteúdo dessas informações extras depende do tipo do evento. Se ExtraInformation for NULL, essas informações não serão retornadas.

[in] ExtraInformationSize

Especifica o tamanho, em bytes, do buffer especificado ExtraInformation.

[out, optional] ExtraInformationUsed

Recebe o tamanho, em bytes, de informações extras. Se ExtraInformationUsed for NULL, essas informações não serão retornadas.

[out, optional] Description

Recebe a descrição do evento. Se Descrição for NULL, essas informações não serão retornadas.

[in] DescriptionSize

Especifica o tamanho, em caracteres, do buffer que Descrição especifica. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] DescriptionUsed

Recebe o tamanho em caracteres da descrição do evento. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se descriptionUsed for NULL, essas informações não serão retornadas.

Valor de retorno

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

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, ExtraInformationSize ou DescriptionSize eram menores que o tamanho dos respectivos dados ou cadeia de caracteres e os dados ou cadeia de caracteres foram truncados para caber dentro do buffer.

Observações

Para eventos de criação de thread e processo, o índice de thread e a ID do processo retornados para ThreadId e ProcessId são para o thread ou processo recém-criado.

Para obter mais informações sobre o último evento, consulte o tópico Informações do Evento.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

GetStoredEventInformation

IDebugControl

IDebugControl2

IDebugControl3

Partilhar via