IDebugControl::GetBreakpointParameters-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetBreakpointParameters-Methode gibt die Parameter eines oder mehrerer Haltepunkte zurück.

Syntax

HRESULT GetBreakpointParameters(
  [in]           ULONG                        Count,
  [in, optional] PULONG                       Ids,
  [in]           ULONG                        Start,
  [out]          PDEBUG_BREAKPOINT_PARAMETERS Params
);

Parameter

[in] Count

Gibt die Anzahl von Haltepunkten an, deren Parameter angefordert werden.

[in, optional] Ids

Gibt ein Array an, das die IDs der Haltepunkte enthält, deren Parameter angefordert werden. Die Anzahl der Elemente in diesem Array muss dem in Count angegebenen Wert entsprechen. Wenn IDsNULL ist, wird stattdessen Start verwendet.

[in] Start

Gibt den Anfangsindex der Haltepunkte an, deren Parameter angefordert werden. Die Parameter für Haltepunkte mit Indizes Start bis Start plus Anzahl minus 1 werden zurückgegeben. Start wird nur verwendet, wenn IDsNULL ist.

[out] Params

Empfängt die Parameter für die angegebenen Haltepunkte. Die Größe dieses Arrays ist gleich dem Wert von Count. Ausführliche Informationen zur zurückgegebenen Struktur finden Sie unter DEBUG_BREAKPOINT_PARAMETERS.

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.
S_FALSE	Die Methode war erfolgreich. Die Parameter für einige der Haltepunkte wurden jedoch nicht zurückgegeben. Für die Parameter, die nicht zurückgegeben wurden, ist ihr Id-Feld auf DEBUG_ANY_ID festgelegt.

Hinweise

Einige der Parameter werden möglicherweise nicht zurückgegeben. Dies geschieht, wenn entweder ein Haltepunkt nicht gefunden werden konnte oder ein Haltepunkt privat ist (siehe GetFlags).