Bagikan melalui

Fungsi PathCchCombine (pathcch.h)

  • Artikel

Menggabungkan dua fragmen jalur ke dalam satu jalur. Fungsi ini juga mekanonikalisasi elemen jalur relatif apa pun, menghapus elemen "." dan ".." untuk menyederhanakan jalur akhir.

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

Fungsi ini berbeda dari PathAllocCombine karena pemanggil harus mendeklarasikan ukuran string yang dikembalikan, yang disimpan pada tumpukan.

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

Catatan Fungsi ini, PathCchCombineEx, atau PathAllocCombine harus digunakan sebagai pengganti PathCombine untuk mencegah kemungkinan buffer diserbu.

Sintaks

WINPATHCCHAPI HRESULT PathCchCombine(
  [out]          PWSTR  pszPathOut,
  [in]           size_t cchPathOut,
  [in, optional] PCWSTR pszPathIn,
  [in, optional] PCWSTR pszMore
);

Parameter

[out] pszPathOut

Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, menerima string jalur gabungan. Parameter ini dapat menunjuk ke buffer yang sama dengan pszPathIn atau pszMore.

[in] cchPathOut

Ukuran buffer yang diacu oleh pszPathOut, dalam karakter.

[in, optional] pszPathIn

Penunjuk ke string jalur pertama. Nilai ini bisa NULL.

[in, optional] pszMore

Penunjuk ke string jalur kedua. Jika jalur ini dimulai dengan garis miring terbalik tunggal, jalur ini hanya dikombinasikan dengan akar jalur yang diacu oleh pszPathIn. Jika jalur ini sepenuhnya memenuhi syarat, jalur ini disalin langsung ke buffer output tanpa digabungkan dengan jalur lain. Nilai ini bisa NULL.

Nilai kembali

Fungsi ini mengembalikan kode HRESULT , termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Fungsi berhasil. Perhatikan bahwa ini juga mencakup kasus ekstensi kosong, seperti titik tanpa karakter yang mengikutinya. Dalam hal ini, string asli dikembalikan tanpa diubah.
E_INVALIDARG
 Nilai ini dapat disebabkan oleh beberapa hal, seperti param pszPathOut yang diatur ke NULL, atau nilai cchPathOut diatur ke 0 atau nilai yang lebih besar dari PATHCCH_MAX_CCH.
E_OUTOFMEMORY
 Fungsi tidak dapat mengalokasikan cukup memori untuk melakukan operasi.
PATHCCH_E_FILENAME_TOO_LONG
 Ukuran satu atau kedua jalur asli melebihi PATHCCH_MAX_CCH.

Keterangan

Jika pszPathIn dan pszMore adalah NULL atau menunjuk ke string kosong, satu garis miring terbalik disalin ke buffer yang diacu oleh pszPathOut.

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

PathCchCanonicalize

PathCchCanonicalizeEx

PathCchCombineEx