Compartir a través de

estructura SYMBOL_INFOW (dbghelp.h)

  • Artículo

Contiene información de símbolos.

Sintaxis

typedef struct _SYMBOL_INFOW {
  ULONG   SizeOfStruct;
  ULONG   TypeIndex;
  ULONG64 Reserved[2];
  ULONG   Index;
  ULONG   Size;
  ULONG64 ModBase;
  ULONG   Flags;
  ULONG64 Value;
  ULONG64 Address;
  ULONG   Register;
  ULONG   Scope;
  ULONG   Tag;
  ULONG   NameLen;
  ULONG   MaxNameLen;
  WCHAR   Name[1];
} SYMBOL_INFOW, *PSYMBOL_INFOW;

Miembros

SizeOfStruct

Tamaño de la estructura, en bytes. Este miembro debe establecerse en sizeof(SYMBOL_INFO). Tenga en cuenta que el tamaño total de los datos es el SizeOfStruct + (MaxNameLen - 1) * sizeof(TCHAR). El motivo para restar uno es que el primer carácter del nombre se tiene en cuenta en el tamaño de la estructura.

TypeIndex

Valor único que identifica los datos de tipo que describen el símbolo. Este valor no se conserva entre sesiones.

Reserved[2]

Este miembro está reservado para uso del sistema.

Index

Valor único del símbolo. No se garantiza que el valor asociado a un símbolo sea el mismo cada vez que ejecute el proceso.

En el caso de los símbolos PDB, el valor de índice de un símbolo no se genera hasta que el símbolo se enumera o recupera a través de una búsqueda por nombre o dirección. Los valores de índice de todos los símbolos CodeView y COFF se generan cuando se cargan los símbolos.

Size

Tamaño del símbolo, en bytes. Este valor solo es significativo si los símbolos del módulo proceden de un archivo pdb; De lo contrario, este valor suele ser cero y debe omitirse.

ModBase

Dirección base del módulo que contiene el símbolo.

Flags

Este miembro puede ser uno o varios de los siguientes valores.

Valor Significado
SYMFLAG_CLR_TOKEN
0x00040000
 El símbolo es un token CLR.
SYMFLAG_CONSTANT
0x00000100
 El símbolo es una constante.
SYMFLAG_EXPORT
0x00000200
 El símbolo procede de la tabla de exportación.
SYMFLAG_FORWARDER
0x00000400
 El símbolo es un reenviador.
SYMFLAG_FRAMEREL
0x00000020
 Los desplazamientos son relativos al marco.
SYMFLAG_FUNCTION
0x00000800
 El símbolo es una función conocida.
SYMFLAG_ILREL
0x00010000
 La dirección del símbolo es un desplazamiento relativo al principio del bloque de idioma intermedio. Esto solo se aplica al código administrado.
SYMFLAG_LOCAL
0x00000080
 El símbolo es una variable local.
SYMFLAG_METADATA
0x00020000
 El símbolo es metadatos administrados.
SYMFLAG_PARAMETER
0x00000040
 El símbolo es un parámetro.
SYMFLAG_REGISTER
0x00000008
 El símbolo es un registro. Se usa el miembro Register.
SYMFLAG_REGREL
0x00000010
 Los desplazamientos son relativos al registro.
SYMFLAG_SLOT
0x00008000
 El símbolo es una ranura de código administrado.
SYMFLAG_THUNK
0x00002000
 El símbolo es un thunk.
SYMFLAG_TLSREL
0x00004000
 El símbolo es un desplazamiento en el área de datos TLS.
SYMFLAG_VALUEPRESENT
0x00000001
 Se usa el miembro Value.
SYMFLAG_VIRTUAL
0x00001000
 El símbolo es un símbolo virtual creado por la función SymAddSymbol.

Value

Valor de una constante.

Address

Dirección virtual del inicio del símbolo.

Register

Registro.

Scope

Ámbito DIA. Para obtener más información, consulte la sdk de acceso a la interfaz de depuración en la documentación de Visual Studio. (Es posible que este recurso no esté disponible en algunos idiomas.

y países.

Tag

Clasificación de PDB. Estos valores se definen en Dbghelp.h en el SymTagEnum tipo de enumeración.

NameLen

Longitud del nombre, en caracteres, no incluido el carácter de terminación null.

MaxNameLen

Tamaño del Nombre búfer, en caracteres. Si este miembro es 0, no se usa el Nombre miembro.

Name[1]

Nombre del símbolo. El nombre puede descodificarse si se usa la opción SYMOPT_UNDNAME con la función SymSetOptions.

Observaciones

Nota

El encabezado dbghelp.h define SYMBOL_INFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
encabezado de dbghelp.h
redistribuible DbgHelp.dll 5.1 o posterior

Consulte también

SymEnumSymbolsProc

SymFromAddr

symFromName

SymGetTypeFromName