Fungsi PathCchRemoveExtension (pathcch.h)

Menghapus ekstensi nama file dari jalur, jika ada.

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

CatatanFungsi ini, harus digunakan sebagai pengganti PathRemoveExtension untuk mencegah kemungkinan buffer diserbu.

Sintaks

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parameter

[in, out] pszPath

Penunjuk ke string jalur. Ketika fungsi ini berhasil dikembalikan, string berisi jalur dengan ekstensi apa pun yang dihapus. Jika tidak ada ekstensi yang ditemukan, string tidak berubah.

[in] cchPath

Ukuran buffer yang diacu oleh pszPath, dalam karakter.

Mengembalikan nilai

Fungsi ini mengembalikan S_OK jika fungsi berhasil, S_FALSE jika tidak ada ekstensi yang ditemukan, atau kode kesalahan sebaliknya.

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