Metodo IDebugControl::GetLastEventInformation (dbgeng.h)

Articolo
02/06/2025

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 dei tipi possibili, vedere DEBUG_EVENT_XXX.

[out] ProcessId

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

[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, verranno restituite DEBUG_ANY_ID.

[out, optional] ExtraInformation

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

[in] ExtraInformationSize

Specifica le dimensioni, in byte, del buffer specificato 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 Descrizione. 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 altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, ExtraInformationSize o DescriptionSize erano 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.

Osservazioni

Per gli eventi di creazione di thread e processi, l'indice del thread e l'ID processo restituiti a ThreadId e ProcessId sono destinati al thread o al processo appena creato.

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