Compartir a través de

Método IDebugAdvanced4::GetSymbolInformationWideEx (dbgeng.h)

  • Artículo

El método GetSymbolInformationWideEx devuelve información especificada sobre un símbolo.

Sintaxis

HRESULT GetSymbolInformationWideEx(
  [in]            ULONG           Which,
  [in]            ULONG64         Arg64,
  [in]            ULONG           Arg32,
  [out, optional] PVOID           Buffer,
  [in]            ULONG           BufferSize,
  [out, optional] PULONG          InfoSize,
  [out, optional] PWSTR           StringBuffer,
  [in]            ULONG           StringBufferSize,
  [out, optional] PULONG          StringSize,
  [out, optional] PSYMBOL_INFO_EX pInfoEx
);

Parámetros

[in] Which

Especifica el fragmento de información que se va a devolver. Qué puede tomar uno de los valores de la tabla siguiente.

Valor Información devuelta
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE Devuelve el nombre de archivo de código fuente y el número de línea de un punto de interrupción especificado. El número de línea se devuelve a buffer como un ULONG. El nombre de archivo se devuelve a stringBuffer.
DEBUG_SYMINFO_IMAGEHLP_MODULEW64 Devuelve una estructura IMAGEHLP_MODULEW64 que describe un módulo especificado. Para obtener más información sobre esta estructura, consulte el tema IMAGEHLP_MODULE64 en la documentación de la biblioteca de ayuda de depuración (dbghelp.chm).

No se devuelve ninguna cadena y stringBuffer, stringBufferSizey stringSize deben establecerse en cero.
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE Devuelve el nombre Unicode del símbolo especificado por ubicación en la memoria y el tipo de etiqueta PDB. El nombre se devuelve a buffer. no se usa StringBuffer.
DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS Devuelve una lista de nombres de símbolos y desplazamientos para los símbolos del módulo especificado con el tipo de etiqueta PDB especificado. Los desplazamientos se devuelven como una matriz de valores de ULONG para buffer. Los nombres se devuelven en el mismo orden que los desplazamientos a StringBuffer. Algunos nombres pueden contener ceros incrustados porque las anotaciones pueden tener nombres de varias partes; por lo tanto, cada nombre finaliza con dos caracteres NULL.

[in] Arg64

Especifica un argumento de 64 bits. Este parámetro tiene las siguientes interpretaciones en función del valor de Que:

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

Ignorado.

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

Dirección base del módulo cuya descripción se solicita.

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

Especifica la dirección en la memoria del destino del símbolo cuyo nombre se solicita.

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

Especifica el módulo cuyos símbolos se solicitan. Arg64 es una ubicación dentro de la asignación de memoria del módulo.

[in] Arg32

Especifica un argumento de 32 bits. Este parámetro tiene las siguientes interpretaciones en función del valor de Que:

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

Identificador del punto de interrupción del motor del punto de interrupción deseado.

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

Establézcalo en cero.

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

Clasificación PDB del símbolo. Arg32 debe ser uno de los valores de la enumeración SymTagEnum definida en Dbghelp.h. Para más información, consulte la documentación de PDB.

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

Clasificación PDB del símbolo. Arg32 debe ser uno de los valores de la enumeración SymTagEnum definida en Dbghelp.h. Para más información, consulte la documentación de PDB.

[out, optional] Buffer

Recibe la información del símbolo solicitado. El tipo de los datos devueltos depende del valor de Que. Si de búfer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño, en bytes, del búfer Búfer.

[out, optional] InfoSize

Si este método devuelve S_OK, InfoSize recibe el tamaño, en bytes, de la información de símbolos devuelta a Búfer. Si este método devuelve S_FALSE, el búfer proporcionado no es lo suficientemente grande y InfoSize recibe el tamaño de búfer necesario. Si infoSize es NULL, no se devuelve esta información.

[out, optional] StringBuffer

Recibe la cadena solicitada. La interpretación de esta cadena depende del valor de Que. Si StringBuffer es NULL, esta información no se devuelve.

[in] StringBufferSize

Especifica el tamaño, en caracteres, del búfer de cadenas stringBuffer.

[out, optional] StringSize

Recibe el tamaño, en caracteres, de la cadena devuelta a StringBuffer. Si StringSize es NULL, esta información no se devuelve.

[out, optional] pInfoEx

Puntero a una estructura SYMBOL_INFO_EX.

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
S_OK
 El método se realizó correctamente.
S_FALSE
 El método se realizó correctamente. Sin embargo, la información no cabería en el búfer Búfer o la cadena no cabería en el búfer stringBuffer, por lo que la información o el nombre se truncaron.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)