Fungsi PathCchRenameExtension (pathcch.h)

Artikel
03/01/2024

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".

Catatan Fungsi ini harus digunakan sebagai pengganti PathRenameExtension untuk mencegah kemungkinan buffer diserbu.

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

Bagikan melalui