Fungsi PathYetAnotherMakeUniqueName (shlobj_core.h)

Membuat nama file unik berdasarkan nama file yang ada.

Sintaks

BOOL PathYetAnotherMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
  [in]           PCWSTR pszPath,
  [in, optional] PCWSTR pszShort,
  [in, optional] PCWSTR pszFileSpec
);

Parameter

[out] pszUniqueName

Jenis: PWSTR

Buffer string yang menerima string Unicode yang dihentikan null yang berisi jalur yang sepenuhnya memenuhi syarat dari nama file unik. Buffer ini harus setidaknya MAX_PATH karakter panjang untuk menghindari menyebabkan buffer diserbu.

[in] pszPath

Jenis: PCWSTR

String Unicode yang dihentikan null yang berisi jalur folder yang sepenuhnya memenuhi syarat yang akan berisi file baru. Jika pszShort diatur ke NULL, untai (karakter) ini harus berisi jalur tujuan lengkap, yang diakhawatirkan dengan nama file panjang yang akan menjadi dasar nama file baru.

[in, optional] pszShort

Jenis: PCWSTR

String Unicode null-terminated yang berisi nama file pendek yang akan menjadi dasar nama unik. Atur nilai ini ke NULL untuk membuat nama berdasarkan nama file panjang.

[in, optional] pszFileSpec

Jenis: PCWSTR

String Unicode yang dihentikan null yang berisi nama file panjang yang akan menjadi dasar nama unik.

Nilai kembali

Jenis: BOOL

Mengembalikan TRUE jika nama unik berhasil dibuat; jika tidak FALSE.

Keterangan

Jika jalur yang dihasilkan melebihi MAX_PATH karakter, fungsi ini dapat mengembalikan string yang dipotong di PathYetAnotherMakeUniqueName. Dalam hal ini, fungsi mengembalikan FALSE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)
Set API	ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

PathMakeUniqueName