SymEnumSourceFiles 函式 (dbghelp.h)
列舉進程中的所有原始程序檔。
語法
BOOL IMAGEAPI SymEnumSourceFiles(
[in] HANDLE hProcess,
[in] ULONG64 ModBase,
[in, optional] PCSTR Mask,
[in] PSYM_ENUMSOURCEFILES_CALLBACK cbSrcFiles,
[in, optional] PVOID UserContext
);
參數
[in] hProcess
進程的句柄。 此句柄先前必須傳遞至 SymInitialize 函式 。
[in] ModBase
模組的基位址。 如果此值為零， Mask 包含驚嘆號 (！) ，則函式會跨模組查看。 如果此值為零， 且 Mask 不包含驚嘆號，則函式會使用 SymSetContext 函式所建立的範圍。
[in, optional] Mask
通配符表達式，指出要列舉的來源檔案名稱。 若要指定模組名稱，請使用 ！mod 語法。
如果此參數為 NULL，函式會列舉所有檔案。
[in] cbSrcFiles
接收來源檔案資訊的 SymEnumSourceFilesProc 回呼函式的指標。
[in, optional] UserContext
傳遞至回呼函式或 NULL 的用戶定義值。 這個參數通常由應用程式用來將指標傳遞至提供回呼函式內容的數據結構。
傳回值
如果函式成功，則傳回值為 TRUE。
如果函式失敗，則傳回值為 FALSE。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。
備註
所有 DbgHelp 函式，例如此函式都是單個線程。 因此，從多個線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況，您必須將所有並行呼叫從多個線程同步處理到此函式。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | dbghelp.h |
| 程式庫 | Dbghelp.lib |
| Dll | Dbghelp.dll |
| 可轉散發套件 | DbgHelp.dll 6.2 或更新版本 |