Fungsi PathMakeUniqueName (shlobj_core.h)

Membuat nama jalur unik dari templat.

Sintaks

BOOL PathMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
                 UINT   cchMax,
  [in]           PCWSTR pszTemplate,
  [in, optional] PCWSTR pszLongPlate,
  [in, optional] PCWSTR pszDir
);

Parameter

[out] pszUniqueName

Jenis: PWSTR

Buffer yang menerima string Unicode null-terminated yang berisi nama jalur unik. Panjangnya harus setidaknya MAX_PATH karakter.

cchMax

Jenis: UINT

Jumlah karakter dalam buffer yang diacu oleh pszUniqueName.

[in] pszTemplate

Jenis: PCWSTR

String Unicode yang dihentikan null yang berisi templat yang digunakan untuk membuat nama unik. Templat ini digunakan untuk drive yang memerlukan nama file dengan format 8.3. Panjang string ini tidak boleh lebih dari MAX_PATH karakter, termasuk karakter null yang mengakhiri.

[in, optional] pszLongPlate

Jenis: PCWSTR

String Unicode yang dihentikan null yang berisi templat yang digunakan untuk membuat nama unik. Templat ini digunakan untuk drive yang mendukung nama file panjang. Panjang string ini tidak boleh lebih dari MAX_PATH karakter, termasuk karakter null yang mengakhiri.

[in, optional] pszDir

Jenis: PCWSTR

String null-terminated yang berisi direktori tempat file baru berada. Panjang string ini tidak boleh lebih dari MAX_PATH karakter, termasuk karakter null yang mengakhiri.

Nilai kembali

Jenis: BOOL

Mengembalikan TRUE jika berhasil; jika tidak, FALSE.

Keterangan

Fungsi ini menghasilkan nama file unik baru berdasarkan templat yang ditentukan oleh pszTemplate, untuk drive yang memerlukan format 8.3, dan pszLongPlate untuk drive yang mendukung nama file panjang. Misalnya, jika Anda menentukan "My New Filename" untuk pszLongPlate, PathMakeUniqueName mengembalikan nama seperti "My New Filename (1)", "My New Filename (2)", dan sebagainya.

Persyaratan

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)