PathMatchSpecExW 関数 (shlwapi.h)

パスのファイル名を 1 つ以上のファイル名パターンと照合します。

構文

LWSTDAPI PathMatchSpecExW(
  [in] LPCWSTR pszFile,
  [in] LPCWSTR pszSpec,
  [in] DWORD   dwFlags
);

パラメーター

[in] pszFile

種類: LPCTSTR

一致するファイル名の取得元のパスを含む null で終わる文字列へのポインター。

[in] pszSpec

種類: LPCTSTR

検索対象のファイル名パターンを含む null で終わる文字列へのポインター。 正確な名前を指定することも、ワイルドカード文字を含めることもできます。 パターンが 1 つだけ指定されている場合は、dwFlags で PMSF_NORMAL フラグを設定します。 複数のパターンを指定する場合は、セミコロンで区切り 、PMSF_MULTIPLE フラグを設定します。

[in] dwFlags

型: DWORD

検索条件を変更します。 有効なフラグを次に示します。

PMSF_NORMAL (0x00000000)

pszSpec パラメーターは、一致する 1 つのファイル名パターンを指します。

PMSF_MULTIPLE (0x00000001)

pszSpec パラメーターは、一致するファイル名パターンのセミコロン区切りのリストを指します。

PMSF_DONT_STRIP_SPACES (0x00010000)

PMSF_NORMALを使用する場合は、pszSpec が指す文字列の先頭のスペースを無視しないでください。 PMSF_MULTIPLEを使用する場合は、pszSpec が指す文字列に含まれる各ファイルの種類の先頭のスペースを無視しないでください。 このフラグは、 PMSF_NORMAL および PMSF_MULTIPLEと組み合わせることができます。

戻り値

型: HRESULT

次のいずれかの値を返します。

リターン コード	説明
S_OK	pszSpec で指定されたファイル名パターンが、pszFile が指す文字列で見つかったファイル名と一致しました。
S_FALSE	pszSpec で指定されたファイル名パターンが、pszFile が指す文字列で見つかったファイル名と一致しません。

注釈

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 7.0 以降)

こちらもご覧ください

PathMatchSpec