Metodo IDebugControl3::GetLastEventInformation (dbgeng.h)

Articolo
08/07/2023

Il metodo GetLastEventInformation restituisce informazioni sull'ultimo evento che si è verificato in una destinazione.

Sintassi

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
);

Parametri

[out] Type

Riceve il tipo dell'ultimo evento generato dalla destinazione. Per un elenco di tipi possibili, vedere DEBUG_EVENT_XXX.

[out] ProcessId

Riceve l'ID processo del processo in cui si è verificato l'evento. Se queste informazioni non sono disponibili, DEBUG_ANY_ID verrà restituita.

[out] ThreadId

Riceve l'indice del thread (non l'ID thread) del thread in cui si è verificato l'ultimo evento. Se queste informazioni non sono disponibili, DEBUG_ANY_ID verrà restituita.

[out, optional] ExtraInformation

Riceve informazioni aggiuntive sull'evento. Il contenuto di queste informazioni aggiuntive dipende dal tipo dell'evento. Se ExtraInformation è NULL, queste informazioni non vengono restituite.

[in] ExtraInformationSize

Specifica le dimensioni, in byte, del buffer specificato da ExtraInformation .

[out, optional] ExtraInformationUsed

Riceve le dimensioni, in byte, di informazioni aggiuntive. Se ExtraInformationUsed è NULL, queste informazioni non vengono restituite.

[out, optional] Description

Riceve la descrizione dell'evento. Se Descrizione è NULL, queste informazioni non vengono restituite.

[in] DescriptionSize

Specifica le dimensioni, in caratteri, del buffer specificato da Description . Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] DescriptionUsed

Riceve le dimensioni in caratteri della descrizione dell'evento. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se DescriptionUsed è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, ExtraInformationSize o DescriptionSize sono stati più piccoli che le dimensioni dei rispettivi dati o stringa e i dati o la stringa sono stati troncati per adattarsi all'interno del buffer.

Commenti

Per gli eventi di creazione di thread e processi, l'ID di thread e l'ID processo restituiti a ThreadId e ProcessId sono per il thread o il processo appena creato.

Per altre informazioni sull'ultimo evento, vedere l'argomento Informazioni sugli eventi.