SymEnumSymbolsForAddrW 函式 (dbghelp.h)
列舉指定位址的符號。
語法
BOOL IMAGEAPI SymEnumSymbolsForAddrW(
[in] HANDLE hProcess,
[in] DWORD64 Address,
[in] PSYM_ENUMERATESYMBOLS_CALLBACKW EnumSymbolsCallback,
[in, optional] PVOID UserContext
);
參數
[in] hProcess
進程的句柄。 此句柄先前必須傳遞至 SymInitialize 函式。
[in] Address
要放置符號的位址。 位址不一定位於符號界限上。 如果位址是在符號的開頭和符號結尾之前(符號開頭加上符號大小),函式會尋找符號。
[in] EnumSymbolsCallback
應用程式定義的回呼函式。 針對位於 Address的每個符號呼叫此函式。 如需詳細資訊,請參閱 SymEnumSymbolsProc。
[in, optional] UserContext
選擇性的使用者定義數據。 這個值會傳遞至回調函式。
傳回值
如果函式成功,則傳回值 TRUE。
如果函式失敗,則傳回值 FALSE。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
言論
所有 DbgHelp 函式,例如此函式,都是單個線程。 因此,從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將多個線程的所有並行呼叫同步至此函式。
若要呼叫此函式的 Unicode 版本,請定義DBGHELP_TRANSLATE_TCHAR。
注意
dbghelp.h 標頭會根據 UNICODE 預處理器常數的定義,將 SymEnumSymbolsForAddr 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | dbghelp.h |
連結庫 | Dbghelp.lib |
DLL | Dbghelp.dll |
可轉散發 | DbgHelp.dll 6.0 或更新版本 |