IDebugControl2::SetTextReplacement-Methode (dbgeng.h)

Artikel
02/23/2024

Die SetTextReplacement-Methode legt den Wert eines alias mit Benutzernamen fest.

Syntax

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

Parameter

[in] SrcText

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

[in, optional] DstText

Gibt den Wert des benutzernamensbasierten Alias an. Die Debugger-Engine erstellt eine Kopie dieser Zeichenfolge. Wenn DstTextNULL ist, wird der alias des Benutzers entfernt.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. 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 Alias (angegeben durch DstText).

Wenn SrcText ein Sternchen (*) und DstTextNULL ist, werden alle benannten Aliase mit Benutzernamen entfernt. Dies ist dasselbe Verhalten wie bei der RemoveTextReplacements-Methode .

Wenn ein Alias von dieser Methode geändert wird, werden die Ereignisrückrufe benachrichtigt, indem das flag DEBUG_CES_TEXT_REPLACEMENTS an die IDebugEventCallbacks::ChangeEngineState-Rückrufmethode ü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.