Metodo IDebugControl4::GetLastEventInformationWide (dbgeng.h)

Articolo
02/23/2024

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

Sintassi

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

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'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 dell'evento, come indicato dal parametro Type restituito. Ad esempio, se Type è un punto di interruzione, ExtraInformation contiene un DEBUG_LAST_EVENT_INFO_BREAKPOINT; se Type è Exception, ExtraInformation contiene un DEBUG_LAST_EVENT_INFO_EXCEPTION. Fare riferimento a DEBUG_EVENT_XXX per l'elenco completo dei tipi di evento e del file di intestazione dbgeng.h per le definizioni di struttura per ogni tipo di 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 Description è 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 altri dettagli, 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 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 del 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include Dbgeng.h)

Vedi anche

GetStoredEventInformation

IDebugControl4

Condividi tramite