IDebugControl2::GetEventFilterCommand-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetEventFilterCommand-Methode gibt den Debuggerbefehl zurück, der von der Engine ausgeführt wird, wenn ein angegebenes Ereignis auftritt.

Syntax

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

Parameter

[in] Index

Gibt den Index des Ereignisfilters an. Index kann einen beliebigen Wert zwischen 0 und eins kleiner als die Gesamtzahl der Ereignisfilter annehmen, die von GetNumberEventFilters (inklusive) zurückgegeben werden. Weitere Informationen zum Index der Filter finden Sie unter Index und Ausnahmecode.

[out, optional] Buffer

Empfängt den Debuggerbefehl, den die Engine beim Eintreten des Ereignisses ausführt.

[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] CommandSize

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