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 パラメーターは、一致する単一のファイル名パターンを指します。

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shlwapi.h
ライブラリ	Shlwapi.lib
DLL	Shlwapi.dll (バージョン 7.0 以降)

関連項目

PathMatchSpec を する