PathCompactPathExW-Funktion (shlwapi.h)

Artikel
03/02/2024

Schneidet einen Pfad ab, der in eine bestimmte Anzahl von Zeichen passt, indem Pfadkomponenten durch Auslassungspunkte ersetzt werden.

Syntax

BOOL PathCompactPathExW(
  [out] LPWSTR  pszOut,
  [in]  LPCWSTR pszSrc,
  [in]  UINT    cchMax,
  [in]  DWORD   dwFlags
);

Parameter

[out] pszOut

Typ: LPTSTR

Die Adresse der geänderten Zeichenfolge.

[in] pszSrc

Typ: LPCTSTR

Ein Zeiger auf eine mit NULL endende Zeichenfolge der Länge MAX_PATH, die den zu ändernden Pfad enthält.

[in] cchMax

Typ: UINT

Die maximale Anzahl von Zeichen, die in der neuen Zeichenfolge enthalten sein sollen, einschließlich des abschließenden NULL-Zeichens. Wenn z. B. cchMax = 8 ist, kann die resultierende Zeichenfolge maximal 7 Zeichen plus das abschließende NULL-Zeichen enthalten.

[in] dwFlags

Art: DWORD

Rückgabewert

Typ: BOOL

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

Hinweise

Das Trennzeichen "/" wird anstelle von "\" verwendet, wenn es von der ursprünglichen Zeichenfolge verwendet wurde. Wenn pszSrc auf einen zu langen Dateinamen zeigt, wird der Dateiname in cchMax-Zeichen abgeschnitten, einschließlich der Auslassungspunkte und des abschließenden NULL-Zeichens . Wenn der Name der Eingabedatei beispielsweise "Mein Dateiname" und cchMax den Wert 10 aufweist, gibt PathCompactPathEx "My Fil..." zurück.

Hinweis

Der shlwapi.h-Header definiert PathCompactPathEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über