PathCompactPathExW-Funktion (shlwapi.h)

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 Zeichenfolge, die geändert wurde.

[in] pszSrc

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge 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 endenden NULL-Zeichens. Wenn z. B. cchMax = 8, kann die resultierende Zeichenfolge maximal 7 Zeichen plus das endende NULL-Zeichen enthalten.

[in] dwFlags

Typ: DWORD-

Rückgabewert

Typ: BOOL-

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

Bemerkungen

Das Trennzeichen '/' wird anstelle von '\' verwendet, wenn die ursprüngliche Zeichenfolge sie verwendet hat. Wenn pszSrc auf einen zu langen Dateinamen zeigt, anstatt auf einen Pfad, wird der Dateiname auf cchMax Zeichen abgeschnitten, einschließlich der Auslassungspunkte und des endenden NULL- Zeichens. Wenn der Eingabedateiname beispielsweise "My Filename" lautet und cchMax 10 ist, gibt PathCompactPathEx "My Fil..." zurück.

Anforderungen