IDebugControl2::SetTextReplacement-Methode (dbgeng.h)

Die SetTextReplacement- -Methode legt den Wert eines benutzerdefinierten Alias fest.

Syntax

HRESULT SetTextReplacement(
  [in]           PCSTR SrcText,
  [in, optional] PCSTR DstText
);

Parameter

[in] SrcText

Gibt den Namen des alias des Benutzers an. Das Debuggermodul eine Kopie dieser Zeichenfolge erstellt. Wenn SrcText- mit dem Namen eines automatischen Alias identisch ist, wird der automatische Alias durch den neuen benutzerdefinierten Alias ausgeblendet.

[in, optional] DstText

Gibt den Wert des vom Benutzer benannten Alias an. Das Debuggermodul erstellt eine Kopie dieser Zeichenfolge. Wenn DstText-NULL-ist, wird der vom Benutzer benannte Alias entfernt.

Rückgabewert

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

Bemerkungen

Bevor Befehle ausgeführt oder Ausdrücke ausgewertet werden, ersetzt das Debuggermodul den durch SrcText- angegebenen Alias durch den Wert des Alias (angegeben durch DstText).

Wenn SrcText- ein Sternchen (*) ist und DstText-NULL-ist, werden alle aliase mit Benutzernamen entfernt. Dies ist das gleiche Verhalten wie die RemoveTextReplacements--Methode.

Wenn ein Alias von dieser Methode geändert wird, werden die Ereignisrückrufe benachrichtigt, indem das DEBUG_CES_TEXT_REPLACEMENTS Flag an die IDebugEventCallbacks::ChangeEngineState Rückrufmethode übergeben wird.

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-.

Anforderungen

Siehe auch

GetTextReplacement-

IDebugControl2-

IDebugControl3-

OutputTextReplacements

RemoveTextReplacements-

SetTextMacro-

Anzeigen (Alias löschen)

as, aS (Set Alias)