Método IDebugControl2::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, se usa Index 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 recorrer en iteración 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, no se devuelve esta información.

[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, no se devuelve esta información.

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.