FindExecutableImageEx 函式 （dbghelp.h）

定位指定的可執行檔。

語法

HANDLE IMAGEAPI FindExecutableImageEx(
  [in]           PCSTR                   FileName,
  [in]           PCSTR                   SymbolPath,
  [out]          PSTR                    ImageFilePath,
  [in, optional] PFIND_EXE_FILE_CALLBACK Callback,
  [in, optional] PVOID                   CallerData
);

Parameters

[in] FileName

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

[in] SymbolPath

符號檔案所在的路徑。 此字串可包含多條以分號分隔的路徑。 要取得符號路徑，請使用 SymGetSearchPath 函式。

[out] ImageFilePath

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

[in, optional] Callback

一個應用程式定義的回調函式，用來驗證是否找到正確的可執行檔案，或該函式是否應該繼續搜尋。 欲了解更多資訊，請參閱 FindExecutableImageProc。

此參數可以是 NULL。

[in, optional] CallerData

回撥功能可選的使用者自訂資料。 此參數可以是 NULL。

返回值

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

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

備註

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

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

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

要求

另請參閱

DbgHelp 函式

FindExecutableImageProc

SymGetSearchPath