Fungsi PathCchRemoveFileSpec (pathcch.h)

Menghapus elemen terakhir dalam string jalur, baik elemen tersebut adalah nama file atau nama direktori. Garis miring terdepan elemen juga dihapus.

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

CatatanFungsi ini harus digunakan sebagai pengganti PathRemoveFileSpec untuk mencegah kemungkinan buffer diserbu.

Sintaks

WINPATHCCHAPI HRESULT PathCchRemoveFileSpec(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parameter

[in, out] pszPath

Penunjuk ke string jalur yang sepenuhnya memenuhi syarat. Ketika fungsi ini berhasil dikembalikan, string akan memiliki elemen terakhir dan garis miring terdepannya dihapus. Fungsi ini tidak memengaruhi jalur akar seperti "C:". Dalam kasus jalur akar, string jalur dikembalikan tanpa diubah. Jika string jalur berakhir dengan garis miring terbelakang, hanya garis miring terbelakang yang dihapus.

[in] cchPath

Ukuran buffer yang diacu oleh pszPath, dalam karakter.

Nilai kembali

Fungsi ini mengembalikan S_OK jika fungsi berhasil, S_FALSE jika tidak ada yang harus dihapus, atau kode kesalahan sebaliknya.

Keterangan

Tabel berikut menunjukkan efek fungsi ini pada pilihan string jalur.

String Asli	String yang Dikembalikan
"C:\path1"	"C:\"
"C:\path1\path2"	"C:\path1"
"C:\path1\"	"C:\path1"
"\\path1\path2\path3"	"\\path1\path2"
"\path1"	"\"

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