PathAddBackslashA-Funktion (shlwapi.h)

Fügt am Ende einer Zeichenfolge einen umgekehrten Schrägstrich hinzu, um die richtige Syntax für einen Pfad zu erstellen. Wenn der Quellpfad bereits einen nachgestellten umgekehrten Schrägstrich aufweist, wird kein umgekehrter Schrägstrich hinzugefügt.

Hinweis Missbrauch dieser Funktion zu einem Pufferüberlauf führen kann. Wir empfehlen die Verwendung des sichereren PathCchAddBackslash oder PathCchAddBackslashEx--Funktion an seiner Stelle.

 

Syntax

LPSTR PathAddBackslashA(
  [in, out] LPSTR pszPath
);

Parameter

[in, out] pszPath

Typ: LPTSTR-

Ein Zeiger auf einen Puffer mit einer Zeichenfolge, die einen Pfad darstellt. Die Größe dieses Puffers muss auf MAX_PATH festgelegt werden, um sicherzustellen, dass die zurückgegebene Zeichenfolge groß genug ist.

Rückgabewert

Typ: LPTSTR-

Ein Zeiger, der beim erfolgreichen Zurückgeben dieser Funktion auf das endende Nullzeichen der neuen Zeichenfolge verweist. Wenn der umgekehrte Schrägstrich aufgrund unzureichender Puffergröße nicht angefügt werden konnte, ist dieser Wert NULL-.

Bemerkungen

Anmerkung

Der Header "shlwapi.h" definiert PathAddBackslash 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 4.71 oder höher)