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

Artículo
02/23/2024

El método GetLastEventInformation devuelve información sobre el último evento que se produjo en un destino.

Sintaxis

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

Recibe el tipo del último evento generado por el destino. Para obtener una lista de los posibles tipos, consulte DEBUG_EVENT_XXX.

[out] ProcessId

Recibe el identificador de proceso del proceso en el que se produjo el evento. Si esta información no está disponible, se devolverá DEBUG_ANY_ID en su lugar.

[out] ThreadId

Recibe el índice del subproceso (no el identificador del subproceso) del subproceso en el que se produjo el último evento. Si esta información no está disponible, se devolverá DEBUG_ANY_ID en su lugar.

[out, optional] ExtraInformation

Recibe información adicional sobre el evento. El contenido de esta información adicional depende del tipo del evento. Si ExtraInformation es NULL, esta información no se devuelve.

[in] ExtraInformationSize

Especifica el tamaño, en bytes, del búfer que especifica ExtraInformation .

[out, optional] ExtraInformationUsed

Recibe el tamaño, en bytes, de información adicional. Si ExtraInformationUsed es NULL, esta información no se devuelve.

[out, optional] Description

Recibe la descripción del evento. Si Description es NULL, esta información no se devuelve.

[in] DescriptionSize

Especifica el tamaño, en caracteres, del búfer que especifica Description . Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] DescriptionUsed

Recibe el tamaño en caracteres de la descripción del evento. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si DescriptionUsed es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, ExtraInformationSize o DescriptionSize eran más pequeños que el tamaño de los datos o cadenas respectivos y los datos o la cadena se truncaron para caber dentro del búfer.

Comentarios

En el caso de los eventos de creación de subprocesos y procesos, el índice de subproceso y el identificador de proceso devueltos a ThreadId y ProcessId son para el subproceso o proceso recién creado.

Para obtener más información sobre el último evento, vea el tema Información del evento.