共用方式為

SymMatchFileNameW 函式 （dbghelp.h）

  • 發行項

比較字串與檔名和路徑。

語法

BOOL IMAGEAPI SymMatchFileNameW(
  [in]            PCWSTR FileName,
  [in]            PCWSTR Match,
  [out, optional] PWSTR  *FileNameStop,
  [out, optional] PWSTR  *MatchStop
);

參數

[in] FileName

要與 Match 參數比較的檔名。

[in] Match

要與 FileName 參數比較的字串。

[out, optional] FileNameStop

字串緩衝區的指標，會接收 FileName 中位置的指標， 已停止比對的位置。 若要完全相符，此值可以是一個字元，再 FileName。 這個值也可以 NULL。

[out, optional] MatchStop

字串緩衝區的指標，接收 Match 中已停止比對位置的指標。 對於完整的比對，此值可能是 Match之前的一個字元。 這個值可能會 NULL。

傳回值

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

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

言論

因為比對字串可以是完整檔名的後綴，因此此函式可用來比對純檔名與完整檔名。

比對會從兩個字串的結尾開始，然後往後繼續。 比對不區分大小寫，並等於反斜杠 （\） 與正斜線 （/）。

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

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

注意

dbghelp.h 標頭會根據 UNICODE 預處理器常數的定義，將 SymMatchFileName 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
目標平臺 窗戶
標頭 dbghelp.h
連結庫 Dbghelp.lib
DLL Dbghelp.dll
可轉散發 DbgHelp.dll 5.1 或更新版本

另請參閱

DbgHelp 函式