Método IDebugControl3::GetTextReplacement (dbgeng.h)
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. El motor busca primero los alias con nombre del usuario para uno con este nombre. 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. index solo se usa si SrcText es NULL. Index 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 de 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 y Index. Si DstBuffer es NULL, esta información no se devuelve.
[in] DstBufferSize
Especifica el tamaño, en caracteres, del búfer de 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 información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
Observaciones
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 de depurador de , consulte Using Aliases. Para obtener más información sobre el uso de alias con la API del motor de depurador, consulte Interacción con el motor.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |