Metodo IDebugControl::GetEventFilterText (dbgeng.h)

Articolo
02/06/2025

Il metodo GetEventFilterText restituisce una breve descrizione di un evento per un filtro specifico.

Sintassi

HRESULT GetEventFilterText(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TextSize
);

Parametri

[in] Index

Specifica l'indice del filtro eventi la cui descrizione verrà restituita. Solo i filtri specifici dispongono di una descrizione associata; Index deve fare riferimento a un filtro specifico.

[out, optional] Buffer

Riceve la descrizione del filtro specifico.

[in] BufferSize

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

[out, optional] TextSize

Riceve le dimensioni della descrizione dell'evento. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se TextSize è 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.
E_NOINTERFACE	Index non fa riferimento a un filtro specifico. Ciò può verificarsi se Index fa riferimento a un filtro di eccezione arbitrario.