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

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

Sintaxis

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

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 identificador de 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 de evento indicado por el parámetro Type devuelto. Por ejemplo, si type es punto de interrupción, extraInformation contiene un DEBUG_LAST_EVENT_INFO_BREAKPOINT; Si Type es Exception, ExtraInformation contiene un DEBUG_LAST_EVENT_INFO_EXCEPTION. Consulte DEBUG_EVENT_XXX para obtener la lista completa de tipos de eventos y el archivo de encabezado dbgeng.h para las definiciones de estructura de cada tipo de 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

En el caso de los eventos de creación de subprocesos y procesos, el identificador 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

IDebugControl4