FindExecutableImage 函式 （dbghelp.h）

找到一個可執行檔案。

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

語法

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

Parameters

[in] FileName

要找到的符號檔案名稱。 此參數可為部分路徑。

[in] SymbolPath

符號檔案所在的路徑。 這可能是多條路徑，中間用分號分隔。 要取得符號路徑，請使用 SymGetSearchPath 函式。

[out] ImageFilePath

一個指向緩衝區的指標，該緩衝區接收可執行檔案的完整路徑。 此緩衝區必須至少為MAX_PATH+1個字元。

返回值

若函式成功，回傳值即為可執行檔案的開啟處理柄。

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

備註

FindExecutableImage 函式的提供，使得可執行檔案能透過單一函式呼叫在多個不同的目錄中定位。 SymbolPath 參數可以包含多條路徑，每條路徑以分號（;) 分隔）。 當指定多條路徑時，函式會搜尋每個目錄樹以尋找可執行檔案。 當檔案被找到後，搜尋即停止。 因此，務必將 SymbolPath 的路徑順序正確指定。

所有 DbgHelp 函式，例如這個，都是單執行緒。 因此，來自多個執行緒對此函式的呼叫，很可能導致意外行為或記憶體損毀。 為避免此情況，您必須將多個執行緒的所有同時呼叫同步至此函式。

要求

另請參閱

DbgHelp 函式

FindExecutableImageEx

SymGetSearchPath