IDebugControl2::GetTextReplacement-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetTextReplacement-Methode gibt den Wert eines benutzernamens 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. Die Engine durchsucht zunächst die benutzernamenten Aliase nach einem Alias mit diesem Namen. Wenn dann keine Übereinstimmung gefunden wird, werden die automatischen Aliase durchsucht. Wenn SrcTextNULL ist, wird Index verwendet, um den Alias anzugeben.

[in] Index

Gibt den Index eines Alias an. Die Indizes der benutzerdefinierten Aliase kommen vor den Indizes der automatischen Aliase. Index wird nur verwendet, wenn SrcTextNULL 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 SrcText angegebene Name, wenn SrcText nicht NULL ist. Wenn SrcBufferNULL 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 Aliasnamens in Zeichen. Wenn SrcSizeNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] DstBuffer

Empfängt den Wert des von SrcText und Index angegebenen 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 Werts 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.

Hinweise

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

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.