SymUnDName-Funktion (dbghelp.h)

Hebt einen ergänzten C++-Symbolnamen auf.

Anwendungen können auch die UnDecorateSymbolName-Funktion verwenden.

Syntax

BOOL IMAGEAPI SymUnDName(
  [in]  PIMAGEHLP_SYMBOL sym,
  [out] PSTR             UnDecName,
  [in]  DWORD            UnDecNameLength
);

Parameter

[in] sym

Ein Zeiger auf eine IMAGEHLP_SYMBOL64-Struktur , die das symbol angibt, das nicht ausgestaltet werden soll.

[out] UnDecName

Ein Zeiger auf einen Puffer, der den nicht zugeordneten Namen empfängt.

[in] UnDecNameLength

Die Größe des UnDecName-Puffers in Zeichen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Diese Funktion ersetzt die SymUnDName-Funktion . Weitere Informationen finden Sie unter Aktualisierte Plattformunterstützung. SymUnDName wird in Dbghelp.h wie folgt definiert.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymUnDName SymUnDName64
#else
BOOL
IMAGEAPI
SymUnDName(
    __in PIMAGEHLP_SYMBOL sym,  
    __out_ecount(UnDecNameLength) PSTR UnDecName,   
    __in DWORD UnDecNameLength 
    );
#endif

Anforderungen

Zielplattform	Windows
Kopfzeile	dbghelp.h
Bibliothek	Dbghelp.lib
DLL	Dbghelp.dll
Verteilbare Komponente	DbgHelp.dll 5.1 oder höher

Weitere Informationen

DbgHelp-Funktionen

UnDecorateSymbolName