共用方式為

SymEnumLinesW 函式 （dbghelp.h）

  • 發行項

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

語法

BOOL IMAGEAPI SymEnumLinesW(
  [in]           HANDLE                   hProcess,
  [in]           ULONG64                  Base,
  [in, optional] PCWSTR                   Obj,
  [in, optional] PCWSTR                   File,
  [in]           PSYM_ENUMLINES_CALLBACKW 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.h 標頭會將 SymEnumLines 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
目標平臺 窗戶
標頭 dbghelp.h
連結庫 Dbghelp.lib
DLL Dbghelp.dll
可轉散發 DbgHelp.dll 6.1 或更新版本

另請參閱

DbgHelp 函式

SymEnumLinesProc