Fungsi PathMatchSpecExA (shlwapi.h)

Mencocokkan nama file dari jalur dengan satu atau beberapa pola nama file.

Sintaksis

LWSTDAPI PathMatchSpecExA(
  [in] LPCSTR pszFile,
  [in] LPCSTR pszSpec,
  [in] DWORD  dwFlags
);

Parameter

[in] pszFile

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang berisi jalur tempat nama file yang akan dicocokkan diambil.

[in] pszSpec

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang berisi pola nama file yang akan dicari. Ini bisa menjadi nama yang tepat, atau dapat berisi karakter kartubebas. Jika tepat satu pola ditentukan, atur bendera PMSF_NORMAL di dwFlags. Jika lebih dari satu pola ditentukan, pisahkan dengan titik koma dan atur bendera PMSF_MULTIPLE.

[in] dwFlags

Jenis: DWORD

Memodifikasi kondisi pencarian. Berikut ini adalah bendera yang valid.

PMSF_NORMAL (0x00000000)

Parameter pszSpec menunjuk ke pola nama file tunggal yang akan dicocokkan.

PMSF_MULTIPLE (0x00000001)

Parameter pszSpec menunjuk ke daftar pola nama file yang dibatasi titik koma yang akan dicocokkan.

PMSF_DONT_STRIP_SPACES (0x00010000)

Jika PMSF_NORMAL digunakan, jangan abaikan spasi di depan dalam string yang ditunjukkan oleh pszSpec. Jika PMSF_MULTIPLE digunakan, jangan abaikan spasi di depan di setiap jenis file yang terkandung dalam string yang ditunjukkan oleh pszSpec. Bendera ini dapat dikombinasikan dengan PMSF_NORMAL dan PMSF_MULTIPLE.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan salah satu nilai berikut.

Mengembalikan kode	Deskripsi
S_OK	Pola nama file yang ditentukan dalam pszSpec cocok dengan nama file yang ditemukan dalam string yang diarahkan oleh pszFile.
S_FALSE	Tidak ada pola nama file yang ditentukan dalam pszSpec cocok dengan nama file yang ditemukan dalam string yang diarahkan oleh pszFile.

Komentar

Nota

Header shlwapi.h mendefinisikan PathMatchSpecEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 7.0 atau yang lebih baru)

Lihat juga

PathMatchSpec