SymEnumSourceLines 函式 (dbghelp.h)
列舉模組中的所有來源行。
語法
BOOL IMAGEAPI SymEnumSourceLines(
[in] HANDLE hProcess,
[in] ULONG64 Base,
[in, optional] PCSTR Obj,
[in, optional] PCSTR File,
[in, optional] DWORD Line,
[in] DWORD Flags,
[in] PSYM_ENUMLINES_CALLBACK EnumLinesCallback,
[in, optional] PVOID UserContext
);
參數
[in] hProcess
進程的句柄。 此句柄先前必須傳遞至 SymInitialize 函式 。
[in] Base
模組的基位址。
[in, optional] Obj
模組內.obj檔案的名稱。 列舉的範圍僅限於此檔案。 如果此參數為 NULL 或空字串,則會搜尋所有.obj檔案。
[in, optional] File
通配符表達式,指出要搜尋的來源檔案名稱。 如果此參數為 NULL 或空字串,則會搜尋所有檔案。
[in, optional] Line
模組內行的行號。 列舉的範圍僅限於這一行。 如果此參數為 0,則會搜尋所有行。
[in] Flags
如果此參數ESLFLAG_FULLPATH,則函式會符合 File 參數中的完整路徑。
[in] EnumLinesCallback
接收行資訊的 SymEnumLinesProc 回呼函式。
[in, optional] UserContext
傳遞至回呼函式或 NULL 的用戶定義值。 這個參數通常由應用程式用來將指標傳遞至提供回呼函式內容的數據結構。
傳回值
如果函式成功,則傳回值為 TRUE。
如果函式失敗,則傳回值為 FALSE。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
備註
所有 DbgHelp 函式,例如此函式都是單個線程。 因此,從多個線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將所有並行呼叫從多個線程同步處理到此函式。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | dbghelp.h |
程式庫 | Dbghelp.lib |
Dll | Dbghelp.dll |
可轉散發套件 | DbgHelp.dll 6.4 或更新版本 |