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
);

參數

[in] FileName

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

[in] SymbolPath

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

[out] ImageFilePath

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

[in, optional] Callback

應用程式定義的回呼函式，可驗證找到正確的可執行檔，或函式是否應該繼續搜尋。 如需詳細資訊，請參閱 FindExecutableImageProc。

此參數可以是 Null。

[in, optional] CallerData

回呼函式的選擇性使用者定義資料。 此參數可以是 Null。

傳回值

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

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

備註

FindExecutableImageEx函式可供使用單一函式呼叫，在數個不同的目錄中找到可執行檔。 如果 SymbolPath 參數包含多個路徑，則函式會搜尋每個指定的目錄樹狀結構中是否有可執行檔。 找到檔案時，搜尋會停止。 因此，請務必以正確的順序指定 SymbolPath 與路徑。

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

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

需求

另請參閱

DbgHelp 函式

FindExecutableImageProc

SymGetSearchPath