Método IDebugControl3::GetTextReplacement (dbgeng.h)

Artículo
08/07/2023

El método GetTextReplacement devuelve el valor de un alias con nombre de usuario o un alias automático.

Sintaxis

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
);

Parámetros

[in, optional] SrcText

Especifica el nombre del alias. En primer lugar, el motor busca uno con este nombre en los alias con nombre del usuario. A continuación, si no se encuentra ninguna coincidencia, se buscan los alias automáticos. Si SrcText es NULL, index se usa para especificar el alias.

[in] Index

Especifica el índice de un alias. Los índices de los alias con nombre de usuario vienen antes de los índices de los alias automáticos. El índice solo se usa si SrcText es NULL. El índice se puede usar junto con GetNumberTextReplacements para iterar todos los alias automáticos y con nombre del usuario.

[out, optional] SrcBuffer

Recibe el nombre del alias. Este es el nombre especificado en SrcText, si SrcText no es NULL. Si SrcBuffer es NULL, esta información no se devuelve.

[in] SrcBufferSize

Especifica el tamaño, en caracteres, del búfer SrcBuffer .

[out, optional] SrcSize

Recibe el tamaño, en caracteres, del nombre del alias. Si SrcSize es NULL, esta información no se devuelve.

[out, optional] DstBuffer

Recibe el valor del alias especificado por SrcText e Index. Si DstBuffer es NULL, esta información no se devuelve.

[in] DstBufferSize

Especifica el tamaño, en caracteres, del búfer DstBuffer .

[out, optional] DstSize

Recibe el tamaño, en caracteres, del valor del alias. Si DstSize es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Antes de ejecutar comandos o evaluar expresiones, el motor del depurador reemplazará el alias especificado por SrcBuffer por el valor del alias (especificado por DstBuffer).

Para obtener información general sobre los alias usados por el motor del depurador, consulte Uso de alias. Para obtener más información sobre el uso de alias con la API del motor de depurador, consulte Interacción con el motor.