SymGetSourceFile 函式 (dbghelp.h)

從來源伺服器擷取指定的來源檔案。

語法

BOOL IMAGEAPI SymGetSourceFile(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCSTR   Params,
  [in]           PCSTR   FileSpec,
  [out]          PSTR    FilePath,
  [in]           DWORD   Size
);

參數

[in] hProcess

進程的控制碼。 此控制碼之前必須傳遞至 SymInitialize 函式 。

[in] Base

模組的基底位址。

[in, optional] Params

不使用這個參數。

[in] FileSpec

原始程式檔的名稱。

[out] FilePath

接收來源檔案完整路徑之緩衝區的指標。

[in] Size

FilePath緩衝區的大小，以字元為單位。

傳回值

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

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

備註

若要控制接收來源檔案的目錄，請使用 SymSetHomeDirectory 函式。

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

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

需求

目標平台	Windows
標頭	dbghelp.h
程式庫	Dbghelp.lib
Dll	Dbghelp.dll
可轉散發套件	DbgHelp.dll 6.2 或更新版本

另請參閱

DbgHelp 函式

來源伺服器