PathMakeUniqueName-Funktion (shlobj_core.h)

  • Artikel

Erstellt einen eindeutigen Pfadnamen aus einer Vorlage.

Syntax

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

Parameter

[out] pszUniqueName

Typ: PWSTR

Ein Puffer, der eine unicode-Zeichenfolge empfängt, die mit NULL beendet ist und den eindeutigen Pfadnamen enthält. Es sollte mindestens MAX_PATH Zeichen lang sein.

cchMax

Typ: UINT

Die Anzahl der Zeichen im Puffer, auf die pszUniqueName verweist.

[in] pszTemplate

Typ: PCWSTR

Eine mit NULL endende Unicode-Zeichenfolge, die eine Vorlage enthält, die zum Erstellen des eindeutigen Namens verwendet wird. Diese Vorlage wird für Laufwerke verwendet, die Dateinamen im Format 8.3 erfordern. Diese Zeichenfolge darf nicht mehr als MAX_PATH Zeichen lang sein, einschließlich des endenden NULL-Zeichens.

[in, optional] pszLongPlate

Typ: PCWSTR

Eine mit NULL endende Unicode-Zeichenfolge, die eine Vorlage enthält, die zum Erstellen des eindeutigen Namens verwendet wird. Diese Vorlage wird für Laufwerke verwendet, die lange Dateinamen unterstützen. Diese Zeichenfolge darf nicht mehr als MAX_PATH Zeichen lang sein, einschließlich des endenden NULL-Zeichens.

[in, optional] pszDir

Typ: PCWSTR

Eine NULL-Zeichenfolge, die das Verzeichnis enthält, in dem sich die neue Datei befindet. Diese Zeichenfolge darf nicht mehr als MAX_PATH Zeichen lang sein, einschließlich des endenden NULL-Zeichens.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn dies erfolgreich war. andernfalls FALSE.

Hinweise

Diese Funktion generiert einen neuen eindeutigen Dateinamen basierend auf den von pszTemplate angegebenen Vorlagen für Laufwerke, die das Format 8.3 erfordern, und pszLongPlate für Laufwerke, die lange Dateinamen unterstützen. Wenn Sie beispielsweise "Mein neuer Dateiname" für pszLongPlate angeben, gibt PathMakeUniqueName Namen wie "Mein neuer Dateiname (1)", "Mein neuer Dateiname (2)" usw. zurück.

Anforderungen

   
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 (shlobj.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)