SymUnDName 函式 (dbghelp.h)

取消編碼裝飾的 C++ 符號名稱。

應用程式也可以使用 UnDecorateSymbolName 函式。

語法

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

參數

[in] sym

IMAGEHLP_SYMBOL64結構的指標，指定要取消編碼的符號。

[out] UnDecName

接收未編碼名稱之緩衝區的指標。

[in] UnDecNameLength

UnDecName緩衝區的大小，以字元為單位。

傳回值

如果函式成功，則傳回值為 TRUE。

如果函式失敗，則傳回值為 FALSE。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

備註

所有 DbgHelp 函式，例如此函式都是單一執行緒。 因此，從多個執行緒呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況，您必須將所有並行呼叫從多個執行緒同步處理到此函式。

此函式會取代 SymUnDName 函式。 如需詳細資訊，請參閱 更新的平臺支援。 SymUnDName 在 Dbghelp.h 中定義如下。

#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

需求

另請參閱

DbgHelp 函式

UnDecorateSymbolName