Bagikan melalui

Fungsi PathCchStripToRoot (pathcch.h)

  • Artikel

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