PathYetAnotherMakeUniqueName 函式 (shlobj_core.h)
根據現有的檔名建立唯一的檔名。
語法
BOOL PathYetAnotherMakeUniqueName(
[out] PWSTR pszUniqueName,
[in] PCWSTR pszPath,
[in, optional] PCWSTR pszShort,
[in, optional] PCWSTR pszFileSpec
);
參數
[out] pszUniqueName
類型： PWSTR
字串緩衝區，接收以 Null 結尾的 Unicode 字串，其中包含唯一檔名的完整路徑。 此緩衝區長度至少應MAX_PATH個字元，以避免造成緩衝區滿溢。
[in] pszPath
類型： PCWSTR
Null 終止的 Unicode 字串，其中包含將包含新檔案的資料夾完整路徑。 如果 pszShort 設定為 NULL，此字串必須包含完整的目的地路徑，以新檔名作為基礎的長檔名結尾。
[in, optional] pszShort
類型： PCWSTR
以 Null 結尾的 Unicode 字串，其中包含唯一名稱所依據的簡短檔名。 將此值設定為 NULL ，以根據長檔名建立名稱。
[in, optional] pszFileSpec
類型： PCWSTR
以 Null 結尾的 Unicode 字串，其中包含唯一名稱所依據的完整檔名。
傳回值
類型： BOOL
如果成功建立唯一名稱，則傳回 TRUE ;否則為 FALSE。
備註
如果產生的路徑超過MAX_PATH個字元，此函式可能會傳回 PathYetAnotherMakeUniqueName中的截斷字串。 在此情況下，函式會傳回 FALSE。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | shlobj_core.h (包含 Shlobj.h) |
| 程式庫 | Shell32.lib |
| Dll | Shell32.dll (5.0 版或更新版本) |
| API 集合 | ext-ms-win-shell32-l1-2-1 (在 Windows 10 10.0.10240 版中引進) |