Metodo IDebugControl2::GetEventFilterText (dbgeng.h)

Articolo
02/23/2024

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 evento la cui descrizione verrà restituita. Solo i filtri specifici hanno una descrizione associata a loro; L'indice 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 dal 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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_NOINTERFACE	L'indice non fa riferimento a un filtro specifico. Ciò può verificarsi se Index fa riferimento a un filtro di eccezione arbitrario.