Método IDebugControl4::GetLastEventInformationWide (dbgeng.h)

Artigo
02/06/2025

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

Sintaxe

HRESULT GetLastEventInformationWide(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PWSTR  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 a ID 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, conforme indicado pelo parâmetro type retornado. Por exemplo, se Tipo for um ponto de interrupção, ExtraInformation contém um DEBUG_LAST_EVENT_INFO_BREAKPOINT; se o Tipo for Exceção, ExtraInformation conterá um DEBUG_LAST_EVENT_INFO_EXCEPTION. Consulte DEBUG_EVENT_XXX para obter a lista completa de tipos de eventos e o arquivo de cabeçalho dbgeng.h para obter as definições de estrutura para cada tipo de 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, a ID do thread e a ID do processo retornadas 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

IDebugControl4

Partilhar via