IDebugControl3::SetTextReplacement-Methode (dbgeng.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

[in] SrcText

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

[in, optional] DstText

Gibt den Wert des benutzerdefinierten Alias an. Das Debuggermodul erstellt eine Kopie dieser Zeichenfolge. Wenn DstTextNULL ist, wird der benutzerdefinierte 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.

Hinweise

Vor dem Ausführen von Befehlen oder Auswerten von Ausdrücken ersetzt die Debugger-Engine den von SrcText angegebenen Alias durch den Wert des Aliass (angegeben durch DstText).

Wenn SrcText ein Sternchen (*) und DstTextNULL ist, werden alle benutzerdefinierten Aliase 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 Rückrufmethode IDebugEventCallbacks::ChangeEngineState übergeben wird.

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.