FindExecutableImage 函式 (dbghelp.h)

發行項
08/23/2023

找出可執行檔。

若要指定回呼函式，請使用 FindExecutableImageEx 函式。

語法

HANDLE IMAGEAPI FindExecutableImage(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  ImageFilePath
);

參數

[in] FileName

要尋找的符號檔名稱。此參數可以是部分路徑。

[in] SymbolPath

符號檔所在的路徑。這可以是以分號分隔的多個路徑。若要擷取符號路徑，請使用 SymGetSearchPath 函式。

[out] ImageFilePath

接收可執行檔完整路徑之緩衝區的指標。

傳回值

如果函式成功，則傳回值是可執行檔的開啟控制碼。

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

備註

提供 FindExecutableImage函式，因此可執行檔可以透過單一函式呼叫位於數個不同的目錄中。 SymbolPath參數可以包含多個路徑，每個路徑都以分號 (;) 分隔。指定多個路徑時，函式會搜尋每個目錄樹狀結構中的可執行檔。當檔案位於時，搜尋會停止。因此，請務必以正確的順序指定 SymbolPath 與路徑。

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