IDebugControl::GetTextMacro-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetTextMacro Methode gibt den Wert eines Alias mit fester Bezeichnung zurück.

Syntax

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

Parameter

[in] Slot

Gibt die Nummer des Alias mit festem Namen an. Slot- können die Werte 0, 1, ..., 9, nehmen, die die Aliase mit festen Namen $u 0, $u 1, ..., $u 9darstellen.

[out, optional] Buffer

Empfängt den Wert des durch Slotangegebenen Alias. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Puffer- Puffers in Zeichen an.

[out, optional] MacroSize

Empfängt die Größe 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.

Bemerkungen

Vor dem Ausführen von Befehlen oder auswerten von Ausdrücken ersetzt das Debuggermodul den durch Slot angegebenen Alias durch den Wert des Alias (zurückgegeben an den puffer Puffer Puffer).

Eine Übersicht über aliase, die vom Debuggermodulverwendet werden, finden Sie unter Using Aliases. Weitere Informationen zur Verwendung von Aliasen mit der Debuggermodul-API finden Sie unter Interaktion mit dem Modul-.