Método IDebugSymbolGroup2::OutputAsTypeWide (dbgeng.h)

Artículo
08/07/2023

El método OutputAsTypeWide cambia el tipo de un símbolo en un grupo de símbolos. La entrada del símbolo se actualiza para representar el nuevo tipo.

Sintaxis

HRESULT OutputAsTypeWide(
  [in] ULONG  Index,
  [in] PCWSTR Type
);

Parámetros

[in] Index

Índice de la entrada de este grupo de símbolos. El índice de un símbolo es un número de identificación. El índice va desde cero hasta el número de símbolos del grupo de símbolos menos uno.

[in] Type

Nombre del tipo del símbolo que desea. Si el nombre comienza con un signo de exclamación (!), el nombre se trata como una extensión. Para obtener más información sobre cómo usar una extensión como tipo, vea la sección Comentarios.

Valor devuelto

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

Este método también puede devolver valores de error. Para obtener más información, vea Valores devueltos.

Comentarios

Dado que los elementos secundarios del nuevo tipo de entrada pueden diferir de los elementos secundarios del tipo de entrada anterior, el método OutputAsTypeWide quita todos los elementos secundarios de la entrada del grupo de símbolos. Puede volver a agregar los elementos secundarios mediante el método ExpandSymbol .

Si Type es una extensión, la dirección del símbolo se pasa a la extensión. Cada línea de salida de la extensión se convierte en un símbolo secundario del símbolo especificado. Estos símbolos secundarios son texto y no se pueden manipular de ninguna manera. Por ejemplo, si el nombre de una variable es @$teb, puede cambiar su tipo a !teb.

Para obtener más información sobre los grupos de símbolos, vea Ámbitos y grupos de símbolos.