PathMatchSpecExA 関数 (shlwapi.h)

  • [アーティクル]

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

構文

LWSTDAPI PathMatchSpecExA(
  [in] LPCSTR pszFile,
  [in] LPCSTR 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 ヘッダーは PathMatchSpecEx をエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

PathMatchSpec