IDebugControl::GetTextMacro-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetTextMacro-Methode gibt den Wert eines Alias mit festen Namen zurück.

Syntax

HRESULT GetTextMacro(
  [in]            ULONG  Slot,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG MacroSize
);

Parameter

[in] Slot

Gibt die Anzahl des Alias mit festem Namen an. Slot kann die Werte 0, 1, ..., 9 annehmen, die die Aliase mit festen Namen $u 0, $u 1, ..., $u 9 darstellen.

[out, optional] Buffer

Empfängt den Wert des durch Slot angegebenen Alias. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Zeichen an.

[out, optional] MacroSize

Empfängt die Größe des Werts des Alias in Zeichen.

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.

Hinweise

Vor dem Ausführen von Befehlen oder Auswerten von Ausdrücken ersetzt die Debugger-Engine den von Slot angegebenen Alias durch den Wert des Alias (zurückgegeben an den Pufferpuffer ).

Eine Übersicht über die von der Debugger-Engine verwendeten Aliase finden Sie unter Verwenden von Aliasen. Weitere Informationen zur Verwendung von Aliasen mit der Debugger-Engine-API finden Sie unter Interagieren mit der Engine.