PathYetAnotherMakeUniqueName-Funktion (shlobj_core.h)
Erstellt einen eindeutigen Dateinamen basierend auf einem vorhandenen Dateinamen.
Syntax
BOOL PathYetAnotherMakeUniqueName(
[out] PWSTR pszUniqueName,
[in] PCWSTR pszPath,
[in, optional] PCWSTR pszShort,
[in, optional] PCWSTR pszFileSpec
);
Parameter
[out] pszUniqueName
Typ: PWSTR
Ein Zeichenfolgenpuffer, der eine mit NULL beendete Unicode-Zeichenfolge empfängt, die den vollqualifizierten Pfad des eindeutigen Dateinamens enthält. Dieser Puffer sollte mindestens MAX_PATH Zeichen lang sein, um einen Pufferüberlauf zu vermeiden.
[in] pszPath
Typ: PCWSTR
Eine Unicode-Zeichenfolge mit Null-Beendigung, die den vollqualifizierten Pfad des Ordners enthält, der die neue Datei enthält. Wenn pszShort auf NULL festgelegt ist, muss diese Zeichenfolge einen vollständigen Zielpfad enthalten, der mit dem langen Dateinamen endet, auf dem der neue Dateinamen basiert.
[in, optional] pszShort
Typ: PCWSTR
Eine Unicode-Zeichenfolge mit NULL-Beendigung, die den kurzen Dateinamen enthält, auf dem der eindeutige Name basiert. Legen Sie diesen Wert auf NULL fest, um einen Namen basierend auf dem langen Dateinamen zu erstellen.
[in, optional] pszFileSpec
Typ: PCWSTR
Eine Unicode-Zeichenfolge mit Null-Beendigung, die den langen Dateinamen enthält, auf dem der eindeutige Name basiert.
Rückgabewert
Typ: BOOL
Gibt TRUE zurück, wenn ein eindeutiger Name erfolgreich erstellt wurde. andernfalls FALSE.
Hinweise
Wenn der generierte Pfad MAX_PATH Zeichen überschreitet, gibt diese Funktion möglicherweise eine abgeschnittene Zeichenfolge in PathYetAnotherMakeUniqueName zurück. In diesem Fall gibt die Funktion FALSE zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h (einschließlich Shlobj.h) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 5.0 oder höher) |
| APIs | ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240) |