Share via

PathYetAnotherMakeUniqueName-Funktion (shlobj_core.h)

  • Artikel

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)

Weitere Informationen

PathMakeUniqueName