Fungsi PathCchAppend (pathcch.h)

Artikel
03/01/2024

Menambahkan satu jalur ke ujung jalur lainnya.

Fungsi ini berbeda dari PathCchAppendEx karena Anda dibatasi untuk jalur akhir panjang MAX_PATH.

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

Catatan Fungsi ini, atau PathCchAppendEx, harus digunakan sebagai pengganti PathAppend untuk mencegah kemungkinan buffer diserbu.

Sintaks

WINPATHCCHAPI HRESULT PathCchAppend(
  [in, out]      PWSTR  pszPath,
  [in]           size_t cchPath,
  [in, optional] PCWSTR pszMore
);

Parameter

[in, out] pszPath

Penunjuk ke buffer yang, pada entri, berisi jalur asli. Ketika fungsi ini berhasil dikembalikan, buffer berisi jalur asli ditambah jalur yang ditambahkan.

[in] cchPath

Ukuran buffer yang diacu oleh pszPath, dalam karakter.

[in, optional] pszMore

Penunjuk ke jalur untuk menambahkan ke akhir jalur yang ditujukkan oleh pszPath. Jalur dan jalur UNC yang dimulai dengan urutan "\?" diterima dan diakui sebagai jalur yang sepenuhnya memenuhi syarat. Jalur ini menggantikan string yang ditujukkan oleh pszPath alih-alih ditambahkan ke dalamnya.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode HRESULT akan dikembalikan, termasuk kode berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Baik pszPath atau pszMoreADALAH NULL, cchPath adalah 0, atau cchPath lebih besar dari PATHCCH_MAX_CCH.
PATHCCH_E_FILENAME_TOO_LONG	String yang dihasilkan akan melebihi PATHCCH_MAX_CCH.
E_OUTOFMEMORY	Fungsi tidak dapat mengalokasikan buffer dengan ukuran yang diperlukan.

Keterangan

Fungsi ini menyisipkan garis miring terbelakang di antara dua string, jika belum ada.

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

PathCchAppendEx

Bagikan melalui