IDebugControl3::GetBreakpointParameters-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetBreakpointParameters Methode gibt die Parameter eines oder mehrerer Haltepunktezurü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 der Haltepunkte 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 Countangegebenen 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 Count minus 1 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 entspricht dem Wert 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. Die parameter, die nicht zurückgegeben wurden, haben ihre ID Feld auf DEBUG_ANY_ID festgelegt.

Bemerkungen

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