IDebugBreakpoint2::GetCommandWide-Methode (dbgeng.h)

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

Syntax

HRESULT GetCommandWide(
  [out, optional] PWSTR  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 BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Puffers in Zeichen, auf den Buffer zeigt.

[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 entsprechend abgeschnitten wurde.

 

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 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 Haltepunkteigenschaften finden Sie unter Steuern von Breakpointflags und -parametern.

Anforderungen

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