Fungsi PathCchRemoveBackslashEx (pathcch.h)

Artikel
03/01/2024

Menghapus garis miring terbelakang di akhir string jalur.

Fungsi ini berbeda dari PathCchRemoveBackslash karena dapat mengembalikan penunjuk ke akhir baru string dan melaporkan jumlah karakter yang tidak digunakan yang tersisa di buffer.

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

Catatan Fungsi ini, atau PathCchRemoveBackslash, harus digunakan sebagai pengganti PathRemoveBackslash untuk mencegah kemungkinan buffer diserbu.

Sintaks

WINPATHCCHAPI HRESULT PathCchRemoveBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

Parameter

[in, out] pszPath

Penunjuk ke string jalur. Ketika fungsi ini berhasil dikembalikan, string berisi jalur dengan garis miring terbelakang berikutnya dihapus. Jika tidak ada garis miring terbelakang yang ditemukan, string tidak berubah.

[in] cchPath

Ukuran buffer yang diacu oleh pszPath, dalam karakter.

[out, optional] ppszEnd

Nilai yang, ketika fungsi ini berhasil dikembalikan, menerima alamat penunjuk ke akhir string baru. Jika string adalah jalur akar seperti "C:", penunjuk menunjuk ke garis miring terbalik; jika tidak, penunjuk menunjuk ke karakter null yang mengakhiri string.

[out, optional] pcchRemaining

Penunjuk ke nilai yang, ketika fungsi ini berhasil dikembalikan, menerima jumlah karakter yang tidak digunakan dalam buffer tujuan, termasuk karakter null yang mengakhiri. Jika string adalah jalur akar seperti "C:", jumlah ini menyertakan garis miring terbalik dalam string tersebut.

Nilai kembali

Fungsi ini mengembalikan S_OK jika fungsi berhasil, S_FALSE jika string adalah jalur akar atau jika tidak ada garis miring terbelakang yang ditemukan, atau kode kesalahan sebaliknya.

Keterangan

Fungsi ini tidak akan menghapus garis miring terbalik dari string jalur akar, seperti "C:".

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

Bagikan melalui