Bagikan melalui

Fungsi PathCchFindExtension (pathcch.h)

  • Artikel

Mencari jalur untuk menemukan ekstensi nama filenya, seperti ".exe" atau ".ini". Fungsi ini tidak mencari ekstensi tertentu; ia mencari keberadaan ekstensi apa pun.

Fungsi ini berbeda dari PathFindExtension karena menerima jalur dengan awalan "\", "\?" dan "\?\UNC".

Catatan Fungsi ini harus digunakan sebagai pengganti PathFindExtension untuk mencegah kemungkinan buffer diserbu.

Sintaks

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

Parameter

[in] pszPath

Penunjuk ke jalur untuk mencari.

[in] cchPath

Ukuran buffer yang diacu oleh pszPath dalam karakter, termasuk terminator null.

[out] ppszExt

Alamat pointer yang, ketika fungsi ini berhasil dikembalikan, menunjuk ke karakter "." yang mendahului ekstensi dalam pszPath. Jika tidak ada ekstensi yang ditemukan, ekstensi menunjuk ke karakter null yang mengakhiri string.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header pathcch.h
Pustaka Pathcch.lib