Compartir a través de

Método IDebugAdvanced3::GetSymbolInformationWide (dbgeng.h)

  • Artículo

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

Sintaxis

HRESULT GetSymbolInformationWide(
  [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
);

Parámetros

[in] Which

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

Valor Información devuelta
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE Devuelve el nombre del 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, StringBufferSize y StringSize deben establecerse en cero.
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE Devuelve el nombre Unicode del símbolo especificado por la ubicación en la memoria y el tipo de etiqueta PDB. El nombre se devuelve a Buffer. StringBuffer no se usa.
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 en 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 termina 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 Cuál:

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 Cuál:

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

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

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

Establecer 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 de símbolo solicitada. El tipo de los datos devueltos depende del valor de Which. Si El búfer es NULL, esta información no se devuelve.

[in] BufferSize

Especifica el tamaño, en bytes, del búfer de 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 Buffer. 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, esta información no se devuelve.

[out, optional] StringBuffer

Recibe la cadena solicitada. La interpretación de esta cadena depende del valor de Which. 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.

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.
S_FALSE
 Método realizado correctamente. Sin embargo, la información no cabería en el búfer de búfer o la cadena no cabría en el búfer StringBuffer, por lo que la información o el nombre se truncaron.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)