SymGetLineFromInlineContextW 函式 (dbghelp.h)
找出指定內嵌內容的來源行。
語法
BOOL IMAGEAPI SymGetLineFromInlineContextW(
[in] HANDLE hProcess,
[in] DWORD64 dwAddr,
[in] ULONG InlineContext,
[in, optional] DWORD64 qwModuleBaseAddress,
[out] PDWORD pdwDisplacement,
[out] PIMAGEHLP_LINEW64 Line
);
參數
[in] hProcess
原本傳遞至 SymInitialize 函式之進程的句柄。
[in] dwAddr
行應所在的位址。 位址不需要位於行界限上。 如果位址出現在行的開頭和行尾之前,就會找到該行。
[in] InlineContext
內嵌內容。
[in, optional] qwModuleBaseAddress
模組的基位址。
[out] pdwDisplacement
從行開頭或零處以位元組為單位的位移。
[out] Line
IMAGEHLP_LINE64 結構的指標。
傳回值
如果函式成功,則傳回值 TRUE。
如果函式失敗,則傳回值 FALSE。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
言論
呼叫端必須先正確配置 行 緩衝區,並填入 IMAGEHLP_LINE64 結構的必要成員,才能呼叫 SymGetLineFromInlineContext。
此函式會傳回另一個函式可能重複使用之緩衝區的指標。 因此,請務必立即將傳回的數據複製到另一個緩衝區。
所有 DbgHelp 函式,例如此函式,都是單個線程。 因此,從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將多個線程的所有並行呼叫同步至此函式。
若要呼叫此函式的 Unicode 版本,請定義 DBGHELP_TRANSLATE_TCHAR。 SymGetLineFromInlineContext 在 Dbghelp.h 中定義如下。
BOOL
IMAGEAPI
SymGetLineFromInlineContextW(
_In_ HANDLE hProcess,
_In_ DWORD64 dwAddr,
_In_ ULONG InlineContext,
_In_opt_ DWORD64 qwModuleBaseAddress,
_Out_ PDWORD pdwDisplacement,
_Out_ PIMAGEHLP_LINEW64 Line
);
#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymGetLineFromInlineContext SymGetLineFromInlineContextW
#endif
注意
dbghelp.h 標頭會根據 UNICODE 預處理器常數的定義,將 SymGetLineFromInlineContext 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | dbghelp.h |
連結庫 | DbgHelp.lib |
DLL | DbgHelp.dll |
可轉散發 | DbgHelp.dll 6.2 或更新版本 |