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

Artigo
02/23/2024

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 por 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 Description for NULL, essas informações não serão retornadas.

[in] DescriptionSize

Especifica o tamanho, em caracteres, do buffer especificado pela Descrição . 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.

Retornar valor

Esse método também pode retornar valores de erro. Consulte 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 foram 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.

Comentários

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.