IDebugControl3::GetEventFilterText-Methode (dbgeng.h)

Artikel
02/26/2024

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 sind mit einer Beschreibung versehen; 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, den Buffer angibt. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.

[out, optional] TextSize

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

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

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