SymMatchFileName

SymMatchFileName 関数 (dbghelp.h) は、文字列をファイル名およびパスと比較する。

SymMatchFileName FileName, Match, FileNameStop, MatchStop

FileName : [str] Match パラメータと比較されるファイル名。
Match : [str] FileName パラメータと比較される文字列。
FileNameStop : [var] 照合が終了した FileName 内の位置を指すポインタを受け取る文字列バッファへのポインタ。完全一致した場合、この値は FileName の先頭より 1 文字前を指すことがある。この値は NULL でもよい。
MatchStop : [var] 照合が終了した Match 内の位置を指すポインタを受け取る文字列バッファへのポインタ。完全一致した場合、この値は Match の先頭より 1 文字前を指すことがある。この値は NULL でもよい。

(プラグイン / モジュール : dbghelp.dll)

解説

SymMatchFileName 関数 (dbghelp.h) は、文字列をファイル名およびパスと比較する。

[戻り値]
関数が成功した場合、戻り値は TRUE である。関数が失敗した場合、戻り値は FALSE
である。拡張エラー情報を取得するには、GetLastError を呼び出す。

[備考]

マッチ文字列は完全なファイル名のサフィックスとすることができるため、この関数を使えば単純なファイル名と完全修飾ファイル名を照合することが可能である。照合は両方の文字列の末尾から始まり、前方向へ進行する。照合は大文字小文字を区別せず、バックスラッシュ
(\\) とスラッシュ (/) を同一視する。この関数を含め、すべての DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報