IDebugBreakpoint::GetCommand-Methode (dbgeng.h)

Die GetCommand-Methode gibt die Befehlszeichenfolge zurück, die ausgeführt wird, wenn ein Haltepunkt ausgelöst wird.

Syntax

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

Parameter

[out, optional] Buffer

Die Befehlszeichenfolge, die ausgeführt wird, wenn der Haltepunkt ausgelöst wird. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Puffers, auf den Puffer verweist, in Zeichen.

[out, optional] CommandSize

Die Größe der Befehlszeichenfolge. Wenn CommandSizeNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich, aber der Puffer war nicht groß genug, um die Befehlszeichenfolge zu halten, sodass die Befehlszeichenfolge so abgeschnitten wurde, dass sie passt.

 

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

Hinweise

Die Befehlszeichenfolge ist eine Liste von Debuggerbefehlen, die durch Semikolons getrennt sind. Diese Befehle werden jedes Mal ausgeführt, wenn der Haltepunkt ausgelöst wird. Die Befehle werden ausgeführt, bevor die Engine alle Ereignisrückrufe darüber informiert, dass der Haltepunkt ausgelöst wurde.

Die GetParameters-Methode gibt auch die Größe des Befehls CommandSize des Haltepunkts zurück.

Weitere Informationen zu Breakpointeigenschaften finden Sie unter Steuern von Breakpointflags und -parametern.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)