IDebugControl2::GetTextReplacement-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetTextReplacement- Methode gibt den Wert eines benutzerdefinierten Alias oder eines automatischen Alias zurück.

Syntax

HRESULT GetTextReplacement(
  [in, optional]  PCSTR  SrcText,
  [in]            ULONG  Index,
  [out, optional] PSTR   SrcBuffer,
  [in]            ULONG  SrcBufferSize,
  [out, optional] PULONG SrcSize,
  [out, optional] PSTR   DstBuffer,
  [in]            ULONG  DstBufferSize,
  [out, optional] PULONG DstSize
);

Parameter

[in, optional] SrcText

Gibt den Namen des Alias an. Das Modul durchsucht zuerst die aliase des Benutzers mit diesem Namen. Wenn keine Übereinstimmung gefunden wird, werden die automatischen Aliase durchsucht. Wenn SrcText-NULL-ist, wird Index- verwendet, um den Alias anzugeben.

[in] Index

Gibt den Index eines Alias an. Die Indizes der vom Benutzer benannten Aliase werden vor den Indizes der automatischen Aliase angezeigt. Index- wird nur verwendet, wenn SrcText-NULL-ist. Index- kann zusammen mit GetNumberTextReplacements verwendet werden, um alle benutzerdefinierten und automatischen Aliase zu durchlaufen.

[out, optional] SrcBuffer

Empfängt den Namen des Alias. Dies ist der in SrcTextangegebene Name, wenn SrcText- nicht NULL-ist. Wenn SrcBuffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] SrcBufferSize

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

[out, optional] SrcSize

Empfängt die Größe des Namens des Alias in Zeichen. Wenn SrcSizeNULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] DstBuffer

Empfängt den Wert des durch SrcText und Indexangegebenen Alias. Wenn DstBufferNULL-ist, werden diese Informationen nicht zurückgegeben.

[in] DstBufferSize

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

[out, optional] DstSize

Empfängt die Größe des Alias in Zeichen. Wenn DstSizeNULL-ist, werden diese Informationen nicht zurückgegeben.

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 SrcBuffer angegebenen Alias durch den Wert des Alias (angegeben durch DstBuffer).

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