次の方法で共有

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

[out, optional] MatchStop

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

戻り値

関数が成功した場合、戻り値は TRUE。

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

備考

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

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

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

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

手記

dbghelp.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SymMatchFileName を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dbghelp.h
ライブラリ Dbghelp.lib
DLL Dbghelp.dll
再頒布可能パッケージの DbgHelp.dll 5.1 以降

関連項目

DbgHelp 関数 の