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

規格需求

另請參閱

DbgHelp 函式

SymEnumSourceFilesProc