Fungsi PathCchAddExtension (pathcch.h)
Menambahkan ekstensi nama file ke string jalur.
Fungsi ini berbeda dari PathAddExtension karena menerima jalur dengan awalan "\", "\?" dan "\?\UNC".
Sintaks
WINPATHCCHAPI HRESULT PathCchAddExtension(
[in, out] PWSTR pszPath,
[in] size_t cchPath,
[in] PCWSTR pszExt
);
Parameter
[in, out] pszPath
Penunjuk ke string jalur. Ketika fungsi ini berhasil dikembalikan, buffer berisi string dengan ekstensi yang ditambahkan. Nilai ini tidak boleh NULL.
[in] cchPath
Ukuran buffer yang diacu oleh pszPath, dalam karakter.
[in] pszExt
Penunjuk ke string ekstensi nama file. String ini dapat diberikan baik dengan atau tanpa periode sebelumnya (".ext" atau "ext").
Nilai kembali
Fungsi ini mengembalikan kode HRESULT , termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Fungsi berhasil. Perhatikan bahwa ini juga mencakup kasus ekstensi kosong, seperti titik tanpa karakter yang mengikutinya. Dalam hal ini, string asli dikembalikan tanpa diubah. |
|
Nilai ini dapat disebabkan oleh beberapa hal, seperti param pszPath yang diatur ke NULL, cchPath diatur ke 0 atau nilai yang lebih besar dari PATHCCH_MAX_CCH, atau string ekstensi yang berisi karakter ilegal atau tidak menjadi ekstensi yang valid. |
|
String asli sudah memiliki ekstensi. |
|
Buffer terlalu kecil untuk menahan string yang dikembalikan. |
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 |
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