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

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 Type for um ponto de interrupção, ExtraInformation conterá um DEBUG_LAST_EVENT_INFO_BREAKPOINT; se Type for Exception, 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 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 eram menores que o tamanho dos respectivos dados ou cadeia de caracteres e os dados ou cadeia de caracteres eram truncados para caber dentro do buffer.

Comentários

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
Plataforma de Destino	Área de Trabalho
Cabeçalho	dbgeng.h (inclua Dbgeng.h)

Confira também

GetStoredEventInformation

IDebugControl4