IDebugControl::GetEventFilterText-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetEventFilterText- Methode gibt eine kurze Beschreibung eines Ereignisses für einen bestimmten Filter zurück.

Syntax

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

Parameter

[in] Index

Gibt den Index des Ereignisfilters an, dessen Beschreibung zurückgegeben wird. Nur die spezifischen Filter enthalten eine Beschreibung. Index- muss auf einen bestimmten Filter verweisen.

[out, optional] Buffer

Empfängt die Beschreibung des spezifischen Filters.

[in] BufferSize

Gibt die Größe des Puffers in Zeichen an, der Puffer- angibt. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] TextSize

Empfängt die Größe der Ereignisbeschreibung. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn TextSize-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_NOINTERFACE	Index- wurde nicht auf einen bestimmten Filter verwiesen. Dies kann auftreten, wenn Index auf einen beliebigen Ausnahmefilter verweist.