UnDecorateSymbolName

The UnDecorateSymbolName function undecorates decorated C++ symbol names.

DWORD UnDecorateSymbolName(
  PCSTR DecoratedName,  
  PSTR UnDecoratedName,  
  DWORD UndecoratedLength,  
  DWORD Flags           
);

Parameters

DecoratedName

[in] Pointer to a null-terminated string that specifies a decorated C++ symbol name. This name can be identified by the first character of the name, which is always a question mark (?).

UnDecoratedName

[in] Pointer to a null-terminated string that specifies the buffer that receives the undecorated name.

UndecoratedLength

[in] Specifies the length of the UnDecoratedName buffer, in bytes.

Flags

[in] Specifies how the decorated name is undecorated. This parameter can be zero or any combination of the following values.

Value	Description
UNDNAME_COMPLETE	Enable full undecoration.
UNDNAME_NO_LEADING_UNDERSCORES	Remove leading underscores from Microsoft keywords.
UNDNAME_NO_MS_KEYWORDS	Disable expansion of Microsoft keywords.
UNDNAME_NO_FUNCTION_RETURNS	Disable expansion of return types for primary declarations.
UNDNAME_NO_ALLOCATION_MODEL	Disable expansion of the declaration model.
UNDNAME_NO_ALLOCATION_LANGUAGE	Disable expansion of the declaration language specifier.
UNDNAME_NO_MS_THISTYPE	Disable expansion of Microsoft keywords on the this type for primary declaration.
UNDNAME_NO_CV_THISTYPE	Disable expansion of CodeView modifiers on the this type for primary declaration.
UNDNAME_NO_THISTYPE	Disable all modifiers on the this type.
UNDNAME_NO_ACCESS_SPECIFIERS	Disable expansion of access specifiers for members.
UNDNAME_NO_THROW_SIGNATURES	Disable expansion of throw-signatures for functions and pointers to functions.
UNDNAME_NO_MEMBER_TYPE	Disable expansion of the static or virtual attribute of members.
UNDNAME_NO_RETURN_UDT_MODEL	Disable expansion of Microsoft model for user-defined type returns.
UNDNAME_32_BIT_DECODE	Undecorate 32-bit decorated names.
UNDNAME_NAME_ONLY	Crack only the name for primary declaration. Returns [scope::]name. Does expand template parameters.
UNDNAME_NO_ARGUMENTS	Do not undecorate function arguments.
UNDNAME_NO_SPECIAL_SYMS	Do not undecorate special names, such as vtable, vcall, vector, metatype, and so on.

Return Values

If the function succeeds, the return value is the number of characters in the UnDecoratedName buffer, not including the NULL terminator.

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

Remarks

If the function fails and returns zero, the content of the UnDecoratedName buffer is undetermined.

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