PathCompactPathExA-Funktion (shlwapi.h)

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

Syntax

BOOL PathCompactPathExA(
  [out] LPSTR  pszOut,
  [in]  LPCSTR 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 beendete 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 beendenden NULL-Zeichens. Wenn z. B. cchMax = 8 ist, kann die resultierende Zeichenfolge maximal 7 Zeichen plus das beendende NULL-Zeichen enthalten.

[in] dwFlags

Art: DWORD

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder 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 anstelle eines Pfads verweist, wird der Dateiname in cchMax-Zeichen gekürzt, einschließlich der Auslassungspunkte und des beendenden NULL-Zeichens . Wenn der Name der Eingabedatei beispielsweise "Mein Dateiname" und cchMax 10 ist, gibt PathCompactPathEx "Meine Fil..." zurück.

Hinweis

Der shlwapi.h-Header definiert PathCompactPathEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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)