symMatchFileName 函式 (dbghelp.h)

比較字串與檔名和路徑。

語法

BOOL IMAGEAPI SymMatchFileName(
  [in]            PCSTR FileName,
  [in]            PCSTR Match,
  [out, optional] PSTR  *FileNameStop,
  [out, optional] PSTR  *MatchStop
);

參數

[in] FileName

要與 Match 參數比較的檔名。

[in] Match

要與 FileName 參數比較的字串。

[out, optional] FileNameStop

字串緩衝區的指標，接收 FileName 中符合停止位置的指標。 如需完整相符專案，此值可以是 FileName 之前的一個字元。 這個值也可以是 NULL。

[out, optional] MatchStop

字串緩衝區的指標，該緩衝區會接收 比對 停止所在位置的指標。 若為完整相符專案，此值可能是 Match 之前的一個字元。 此值可以是 NULL。

傳回值

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

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

備註

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

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

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

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

規格需求

另請參閱

DbgHelp 函式