Fungsi PathCchRenameExtension (pathcch.h)
Mengganti ekstensi nama file di akhir string jalur dengan ekstensi baru. Jika string jalur tidak diakhir dengan ekstensi, ekstensi baru ditambahkan.
Fungsi ini berbeda dari PathRenameExtension karena menerima jalur dengan awalan "\", "\?" dan "\?\UNC".
Sintaks
WINPATHCCHAPI HRESULT PathCchRenameExtension(
[in, out] PWSTR pszPath,
[in] size_t cchPath,
[in] PCWSTR pszExt
);
Parameter
[in, out] pszPath
Penunjuk ke string jalur. Ketika fungsi ini berhasil dikembalikan, nilai ini menunjuk ke string yang sama, tetapi dengan ekstensi yang diganti namanya atau ditambahkan.
[in] cchPath
Ukuran buffer yang diacu oleh pszPath, dalam karakter.
[in] pszExt
Penunjuk ke string ekstensi baru. Karakter '.' utama bersifat opsional. Dalam kasus string kosong (""), ekstensi yang ada dalam string jalur akan dihapus.
Nilai kembali
Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan 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 |