PathMakeUniqueName 函式 (shlobj_core.h)

從範本建立唯一的路徑名稱。

語法

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

參數

[out] pszUniqueName

類型： PWSTR

緩衝區，接收包含唯一路徑名稱的 Null 終止 Unicode 字串。 長度至少應為MAX_PATH個字元。

cchMax

類型： UINT

pszUniqueName所指向緩衝區中的字元數。

[in] pszTemplate

類型： PCWSTR

以 Null 結尾的 Unicode 字串，其中包含用來建構唯一名稱的範本。 此範本用於需要 8.3 格式檔案名的磁片磁碟機。 此字串長度不應超過 MAX_PATH 個字元，包括終止的 Null 字元。

[in, optional] pszLongPlate

類型： PCWSTR

以 Null 結尾的 Unicode 字串，其中包含用來建構唯一名稱的範本。 此範本用於支援長檔名的磁片磁碟機。 此字串長度不應超過 MAX_PATH 個字元，包括終止的 Null 字元。

[in, optional] pszDir

類型： PCWSTR

以 Null 結束的字串，其中包含新檔案所在的目錄。 此字串長度不應超過 MAX_PATH 個字元，包括終止的 Null 字元。

傳回值

類型： BOOL

如果成功，則傳回 TRUE ;否則為 FALSE。

備註

此函式會根據 pszTemplate所指定的範本，針對需要 8.3 格式的磁片磁碟機，以及支援長檔名的磁片磁碟機 產生 pszLongPlate 的新唯一檔案名。 例如，如果您為 pszLongPlate指定 「My New Filename」， PathMakeUniqueName 會傳回名稱，例如 「My New Filename (1) 」、「My New Filename (2) 」等等。

需求

最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h)
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)