SymEnumLines 函式 (dbghelp.h)

列舉指定模組中的所有行。

語法

BOOL IMAGEAPI SymEnumLines(
  [in]           HANDLE                  hProcess,
  [in]           ULONG64                 Base,
  [in, optional] PCSTR                   Obj,
  [in, optional] PCSTR                   File,
  [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] EnumLinesCallback

接收行資訊的 SymEnumLinesProc 回 呼函式。

[in, optional] UserContext

傳遞至回呼函式或 Null的使用者定義值。 這個參數通常由應用程式用來傳遞資料結構的指標，以提供回呼函式的內容。

傳回值

如果函式成功，則傳回值為 TRUE。

如果函式失敗，傳回值為 FALSE。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

備註

只有 PDB 資訊才支援此函式。 如果您有 COFF 資訊，請嘗試使用其中一個 SymGetLineXXX 函式。

所有 DbgHelp 函式，例如此函式都是單一執行緒。 因此，從一個以上的執行緒呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況，您必須將所有並行呼叫從一個以上的執行緒同步至此函式。

若要呼叫此函式的 Unicode 版本，請定義DBGHELP_TRANSLATE_TCHAR。

需求

另請參閱

DbgHelp 函式

SymEnumLinesProc