PathUndecorateW-Funktion (shlwapi.h)

  • Artikel

Entfernt die Dekoration aus einer Pfadzeichenfolge.

Syntax

void PathUndecorateW(
  [in, out] LPWSTR pszPath
);

Parameter

[in, out] pszPath

Typ: LPTSTR

Eine Zeichenfolge mit NULL-Endung der Länge MAX_PATH, die den Pfad enthält. Wenn die Funktion zurückgegeben wird, zeigt pszPath auf die nicht zugeordnete Zeichenfolge.

Rückgabewert

Keine

Bemerkungen

Eine Dekoration besteht aus einem Paar eckiger Klammern mit einer oder mehreren Ziffern dazwischen, die unmittelbar nach dem Basisnamen und vor der Dateinamenerweiterung eingefügt werden.

Beispiele

Die folgende Tabelle veranschaulicht, wie Zeichenfolgen von PathUndecorate geändert werden.

Anfängliche Zeichenfolge Nicht ausgebuchte Zeichenfolge
C:\Path\File[5].txt C:\Path\File.txt
C:\Path\File[12] C:\Path\File
C:\Path\File.txt C:\Path\File.txt
C:\Path\[3].txt C:\Path\[3].txt
 

Hinweis

Der shlwapi.h-Header definiert PathUndecorate 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 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 5.0 oder höher)