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 の前に 1 文字にすることができます。 この値は NULL にすることもできます。

[out, optional] MatchStop

一致が停止した Match 内の場所へのポインターを受け取る文字列バッファーへのポインター。 完全一致の場合、この値は Match の前に 1 文字である可能性があります。 この値は NULL である可能性があります。

戻り値

関数が成功した場合、戻り値は TRUE になります

関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報を取得するには、 GetLastError を呼び出します。

注釈

一致文字列には完全なファイル名のサフィックスを付けることができるため、この関数を使用して、プレーン ファイル名と完全修飾ファイル名を照合できます。

照合は両方の文字列の末尾から始まり、後方に進みます。 照合では大文字と小文字が区別されず、円記号 (\) とスラッシュ (/) が同じになります。

この関数など、すべての DbgHelp 関数はシングル スレッドです。 そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。 これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。

この関数の Unicode バージョンを呼び出すには、DBGHELP_TRANSLATE_TCHARを定義します。

要件

要件
対象プラットフォーム Windows
ヘッダー dbghelp.h
Library Dbghelp.lib
[DLL] Dbghelp.dll
再頒布可能パッケージ DbgHelp.dll 5.1 以降

こちらもご覧ください

DbgHelp 関数