Platform SDK: Debugging and Error Handling

SymUnDName

The SymUnDName function undecorates a decorated symbol.

This function is implemented as a wrapper that calls SymUnDName64. For more information, see New 64-bit Functions.

BOOL SymUnDName(
  PIMAGEHLP_SYMBOL Symbol,  
  PSTR UnDecName,       
  DWORD UnDecNameLength  
);

For SymUnDName64, the parameter list is as follows.

BOOL SymUnDName64(
  PIMAGEHLP_SYMBOL64 Symbol,  
  PSTR UnDecName,       
  DWORD UnDecNameLength  
);

Parameters

Symbol
[in] Specifies the symbol to be undecorated.
UnDecName
[out] Specifies the buffer that receives the undecorated symbol name.
UnDecNameLength
[in] Specifies the length of the UnDecName buffer, in bytes.

Return Values

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

The UnDecName buffer contains the undecorated symbol name. However, if the buffer is too small, the name is truncated to UnDecNameLength length.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Dbghelp.h.
  Library: Use Dbghelp.lib.

See Also

Debug Help Library Overview, DbgHelp Functions