IDebugControl2::SetTextReplacement-Methode (dbgeng.h)

Artikel
02/06/2025

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.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

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