estrutura IMAGEHLP_SYMBOL (dbghelp.h)

  • Artigo

Contém informações de símbolo.

Sintaxe

typedef struct _IMAGEHLP_SYMBOL {
  DWORD SizeOfStruct;
  DWORD Address;
  DWORD Size;
  DWORD Flags;
  DWORD MaxNameLength;
  CHAR  Name[1];
} IMAGEHLP_SYMBOL, *PIMAGEHLP_SYMBOL;

Membros

SizeOfStruct

O tamanho da estrutura em bytes. O chamador deve definir esse membro como sizeof(IMAGEHLP_SYMBOL64).

Address

O endereço virtual do símbolo.

Size

O tamanho do símbolo, em bytes. Esse valor é uma melhor suposição e pode ser zero.

Flags

Esse membro é reservado para uso pelo sistema operacional.

MaxNameLength

O comprimento máximo da cadeia de caracteres que o membro Name pode conter, em caracteres, não incluindo o caractere de terminação nula. Como os nomes de símbolo podem variar de comprimento, essa estrutura de dados é alocada pelo chamador. Esse membro é usado para que a biblioteca saiba quanta memória está disponível para uso pelo nome do símbolo.

Name[1]

O nome do símbolo decorado ou não decorado. Se o buffer não for grande o suficiente para o nome completo, ele será truncado para caracteres MaxNameLength , incluindo o caractere de terminação nula.

Comentários

Essa estrutura substitui a estrutura IMAGEHLP_SYMBOL . Para obter mais informações, consulte Suporte de plataforma atualizado. IMAGEHLP_SYMBOL é definido da seguinte maneira em DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
 #define IMAGEHLP_SYMBOL IMAGEHLP_SYMBOL64
 #define PIMAGEHLP_SYMBOL PIMAGEHLP_SYMBOL64
#else
 typedef struct _IMAGEHLP_SYMBOL {
     DWORD SizeOfStruct; 
     DWORD Address; 
     DWORD Size; 
     DWORD Flags;  
     DWORD MaxNameLength; 
     CHAR  Name[1];  
 } IMAGEHLP_SYMBOL, *PIMAGEHLP_SYMBOL;
#endif

Requisitos

   
Cabeçalho dbghelp.h
Redistribuível DbgHelp.dll 5.1 ou posterior

Confira também

SymGetSymFromAddr64

SymGetSymFromName64