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

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 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 extraInformation especifica.

[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 descripción es NULL, esta información no se devuelve.

[in] DescriptionSize

Especifica el tamaño, en caracteres, del búfer que Descripción especifica. 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, no se devuelve esta información.

Valor devuelto

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

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
S_FALSE	El método se realizó 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.

Observaciones

Para 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 creados.

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)

Consulte también

GetStoredEventInformation

IDebugControl

IDebugControl2

IDebugControl3