Fungsi PathCchAddBackslashEx (pathcch.h)

  • Artikel

Menambahkan garis miring terbalik ke akhir string untuk membuat sintaks yang benar untuk jalur. Jika jalur sumber sudah memiliki garis miring terbalik berikutnya, tidak ada garis miring terbalik yang akan ditambahkan.

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

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

Catatan Fungsi ini, atau PathCchAddBackslash, harus digunakan sebagai pengganti PathAddBackslash untuk mencegah kemungkinan buffer diserbu.

Sintaks

WINPATHCCHAPI HRESULT PathCchAddBackslashEx(
  [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, buffer berisi string dengan garis miring terbalik yang ditambahkan. Nilai ini tidak boleh NULL.

[in] cchPath

Ukuran buffer yang diacu oleh pszPath, dalam karakter.

[out, optional] ppszEnd

Nilai yang, ketika fungsi ini berhasil dikembalikan, menerima alamat penunjuk ke karakter null yang mengakhiri di akhir string.

[out, optional] pcchRemaining

Penunjuk ke nilai yang, ketika fungsi ini berhasil dikembalikan, diatur ke jumlah karakter yang tidak digunakan dalam buffer tujuan, termasuk karakter null yang mengakhiri.

Nilai kembali

Fungsi ini mengembalikan S_OK jika fungsi berhasil, S_FALSE jika string jalur sudah berakhir dengan garis miring terbelakang, atau kode kesalahan sebaliknya.

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

Lihat juga

PathCchAddBackslash