Fungsi PathAllocCombine (pathcch.h)
Menggabungkan dua fragmen jalur menjadi satu jalur. Fungsi ini juga mengkanonikalisasi elemen jalur relatif apa pun, mengganti elemen jalur seperti "." dan "..".
Fungsi ini berbeda dari PathCchCombine dan PathCchCombineEx karena mengembalikan hasil pada heap. Ini berarti bahwa pemanggil tidak harus mendeklarasikan ukuran string yang dikembalikan dan mengurangi penggunaan tumpukan.
Fungsi ini berbeda dari PathCombine karena menerima jalur dengan awalan "\", "\?" dan "\?\UNC".
Sintaks
WINPATHCCHAPI HRESULT PathAllocCombine(
[in] PCWSTR pszPathIn,
[in] PCWSTR pszMore,
[in] ULONG dwFlags,
[out] PWSTR *ppszPathOut
);
Parameter
[in] pszPathIn
Penunjuk ke string jalur pertama.
[in] 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.
[in] dwFlags
Satu atau beberapa bendera berikut:
[out] ppszPathOut
Alamat pointer ke buffer yang, ketika fungsi ini berhasil kembali, menerima string jalur gabungan. Pemanggil bertanggung jawab untuk membebaskan sumber daya ini, ketika tidak lagi diperlukan, dengan memanggil fungsi LocalFree . Nilai ini tidak boleh NULL.
Mengembalikan nilai
Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Meskipun pszPathIn atau pszMore dapat NULL, keduanya tidak boleh NULL.
Fungsi ini mendukung formulir jalur alternatif ini:
- \\?\
- \\?\\UNC\
- \\?\Volume{guid}\
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk