SymFunctionTableAccess function (dbghelp.h)

Article
02/22/2024

Retrieves the function table entry for the specified address.

Syntax

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

Parameters

[in] hProcess

A handle to the process that was originally passed to the SymInitialize function.

[in] AddrBase

The base address for which function table information is required.

Return value

If the function succeeds, the return value is a pointer to the function table entry.

If the function fails, the return value is NULL. To retrieve extended error information, call GetLastError.

Remarks

The type of pointer returned is specific to the image from which symbols are loaded.

x86: If the image is for an x86 system, this is a pointer to an FPO_DATA structure.

x64: If the image is for an x64 system, this is a pointer to an _IMAGE_RUNTIME_FUNCTION_ENTRY structure.

All DbgHelp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.

This function supersedes the SymFunctionTableAccess function. For more information, see Updated Platform Support. SymFunctionTableAccess is defined as follows in Dbghelp.h.

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

Requirements

Requirement	Value
Target Platform	Windows
Header	dbghelp.h
Library	Dbghelp.lib
DLL	Dbghelp.dll
Redistributable	DbgHelp.dll 5.1 or later