nf-dbghelp-symunloadmodule.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:dbghelp.SymUnloadModule	SymUnloadModule function (dbghelp.h)	Unloads the symbol table. (SymUnloadModule)	SymUnloadModule SymUnloadModule function SymUnloadModule64 SymUnloadModule64 function _win32_symunloadmodule64 base.symunloadmodule64 dbghelp/SymUnloadModule dbghelp/SymUnloadModule64	base\symunloadmodule64.htm	Debug	f4801039-eba2-4ec3-8c23-706ab89bb442	12/05/2018	SymUnloadModule, SymUnloadModule function, SymUnloadModule64, SymUnloadModule64 function, _win32_symunloadmodule64, base.symunloadmodule64, dbghelp/SymUnloadModule, dbghelp/SymUnloadModule64	dbghelp.h		Windows												Dbghelp.lib	Dbghelp.dll		Windows		DbgHelp.dll 5.1 or later	19H1	SymUnloadModule dbghelp/SymUnloadModule	c++	APIRef kbSyntax	DllExport	Dbghelp.dll imagehlp.dll	SymUnloadModule64 SymUnloadModule

SymUnloadModule function

-description

Unloads the symbol table.

-parameters

-param hProcess [in]

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

-param BaseOfDll [in]

The base address of the module that is to be unloaded.

-returns

If the function succeeds, the return value is TRUE.

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

-remarks

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 SymUnloadedModule function. For more information, see Updated Platform Support. SymUnloadedModule is defined as follows in Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymUnloadModule SymUnloadModule64
#else
BOOL
IMAGEAPI
SymUnloadModule(
    __in HANDLE hProcess,
    __in DWORD BaseOfDll
    );
#endif

Examples

For an example, see Unloading a Symbol Module.

-see-also

DbgHelp Functions

SymInitialize