Função SymFunctionTableAccess (dbghelp.h)

Artigo
03/05/2024

Recupera a entrada da tabela de funções para o endereço especificado.

Sintaxe

PVOID IMAGEAPI SymFunctionTableAccess(
  [in] HANDLE hProcess,
  [in] DWORD  AddrBase
);

Parâmetros

[in] hProcess

Um identificador para o processo que foi originalmente passado para a função SymInitialize .

[in] AddrBase

O endereço base para o qual as informações da tabela de funções são necessárias.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para a entrada da tabela de funções.

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

O tipo de ponteiro retornado é específico para a imagem da qual os símbolos são carregados.

x86: Se a imagem for para um sistema x86, esse será um ponteiro para uma estrutura FPO_DATA .

x64: Se a imagem for para um sistema x64, esse será um ponteiro para uma estrutura _IMAGE_RUNTIME_FUNCTION_ENTRY .

Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Essa função substitui a função SymFunctionTableAccess . Para obter mais informações, consulte Suporte de plataforma atualizado. SymFunctionTableAccess é definido da seguinte maneira em Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymFunctionTableAccess SymFunctionTableAccess64
#else
PVOID
IMAGEAPI
SymFunctionTableAccess(
    __in HANDLE hProcess,
    __in DWORD AddrBase
    );
#endif