Fungsi PathCchStripToRoot (pathcch.h)

Menghapus semua elemen file dan direktori dalam jalur kecuali untuk informasi akar.

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

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

Sintaks

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

Parameter

[in, out] pszPath

Penunjuk ke string jalur. Ketika fungsi ini berhasil dikembalikan, string ini hanya berisi informasi akar yang diambil dari jalur tersebut.

[in] cchPath

Ukuran buffer yang diacu oleh pszPath, dalam karakter.

Nilai kembali

Fungsi ini mengembalikan S_OK jika jalur dipotok, S_FALSE jika jalur sudah hanya akar, atau kode kegagalan HRESULT .

Keterangan

Beberapa contoh efek fungsi ini:

String awal	String akhir
"C:\path1\path2\file"	"C:\"
"\\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