SymRegisterCallback 函式 (dbghelp.h)
註冊回呼函式以供符號處理程式使用。
語法
BOOL IMAGEAPI SymRegisterCallback(
[in] HANDLE hProcess,
[in] PSYMBOL_REGISTERED_CALLBACK CallbackFunction,
[in] PVOID UserContext
);
參數
[in] hProcess
原本傳遞至 SymInitialize 函式之進程的句柄。
[in] CallbackFunction
SymRegisterCallbackProc64 回呼函式。
[in] UserContext
用戶定義的值或 NULL。 這個值只會傳遞至回呼函式。 一般而言,應用程式會使用此參數來傳遞數據結構的指標,讓回呼函式建立一些內容。
傳回值
如果函式成功,則傳回值為 TRUE。
如果函式失敗,則傳回值為 FALSE。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
備註
SymRegisterCallback64 函式可讓應用程式註冊回呼函式以供符號處理程式使用。 當應用程式有狀態或進度資訊時,符號處理程式會呼叫已註冊的回呼函式。
所有 DbgHelp 函式,例如此函式都是單個線程。 因此,從多個線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將所有並行呼叫從多個線程同步處理到此函式。
若要呼叫此函式的 Unicode 版本,請定義DBGHELP_TRANSLATE_TCHAR。 SymRegisterCallbackW64 的定義如下 Dbghelp.h。
BOOL
IMAGEAPI
SymRegisterCallbackW64(
__in HANDLE hProcess,
__in PSYMBOL_REGISTERED_CALLBACK64 CallbackFunction,
__in ULONG64 UserContext
);
#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymRegisterCallback64 SymRegisterCallbackW64
#endif
此函式會取代 SymRegisterCallback 函式。 如需詳細資訊,請參閱 更新的平台支援。 SymRegisterCallback 的定義如下:Dbghelp.h。
#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymRegisterCallback SymRegisterCallback64
#else
BOOL
IMAGEAPI
SymRegisterCallback(
__in HANDLE hProcess,
__in PSYMBOL_REGISTERED_CALLBACK CallbackFunction,
__in_opt PVOID UserContext
);
#endif
如需更廣泛的範例,請參閱 取得通知。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | dbghelp.h |
程式庫 | Dbghelp.lib |
Dll | Dbghelp.dll |
可轉散發套件 | DbgHelp.dll 5.1 或更新版本 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應