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 函式，例如此函式都是單個線程。 因此，從多個線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況，您必須將所有並行呼叫從多個線程同步處理到此函式。

規格需求

另請參閱

DbgHelp 函式

SymEnumLinesProc

SymInitialize