Fungsi PathCchAddExtension (pathcch.h)

Artikel
03/01/2024

Menambahkan ekstensi nama file ke string jalur.

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

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

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.

Catatan Jika string asli sudah memiliki ekstensi nama file yang ada, tidak ada ekstensi baru yang akan ditambahkan dan string asli tidak akan berubah.

[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
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 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.
S_FALSE	String asli sudah memiliki ekstensi.
PATHCCH_E_FILENAME_TOO_LONG	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

Bagikan melalui