Metodo IDebugControl4::GetStoredEventInformation (dbgeng.h)

Il metodo GetStoredEventInformation recupera informazioni su un evento di interesse disponibile nella destinazione corrente.

Sintassi

HRESULT GetStoredEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  Context,
  [in]            ULONG  ContextSize,
  [out, optional] PULONG ContextUsed,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed
);

Parametri

[out] Type

Riceve il tipo dell'evento archiviato. 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] Context

Riceve il contesto del thread dell'evento archiviato. Il tipo di contesto del thread è la struttura CONTEXT per il processore effettivo della destinazione al momento dell'evento. Il buffer contesto deve essere sufficientemente grande da contenere questa struttura. Se context è NULL, queste informazioni non vengono restituite.

[in] ContextSize

Specifica le dimensioni, in byte, del buffer specificato Contesto.

[out, optional] ContextUsed

Riceve le dimensioni in byte del contesto. Se ContextUsed è NULL, queste informazioni non vengono restituite.

[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.

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.

Osservazioni

Molte destinazioni non hanno un evento di interesse.

Se la destinazione è un file minidump in modalità utente, il generatore di file di dump potrebbe archiviare un evento aggiuntivo. In genere, si tratta dell'evento che ha provocato il generatore per salvare il file di dump.

Per altre informazioni, vedere l'argomento informazioni sugli eventi.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h, Ntddk.h)

Vedere anche

GetLastEventInformation

IDebugControl4