PathCchAddBackslash-Funktion (pathcch.h)

  • Artikel

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

Diese Funktion unterscheidet sich von PathCchAddBackslashEx dadurch, dass Sie auf einen letzten Pfad der Länge MAX_PATH beschränkt sind.

Diese Funktion unterscheidet sich von PathAddBackslash dadurch, dass sie Pfade mit den Präfixen "\", "\?" und "\?\UNC" akzeptiert.

Hinweis Diese Funktion oder PathCchAddBackslashEx sollte anstelle von PathAddBackslash verwendet werden, um die Möglichkeit eines Pufferüberlaufs zu verhindern.

Syntax

WINPATHCCHAPI HRESULT PathCchAddBackslash(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parameter

[in, out] pszPath

Ein Zeiger auf die Pfadzeichenfolge. Wenn diese Funktion erfolgreich zurückgegeben wird, enthält der Puffer die Zeichenfolge mit dem angefügten umgekehrten Schrägstrich. Dieser Wert sollte nicht NULL sein.

[in] cchPath

Die Größe des Puffers, auf den pszPath in Zeichen verweist.

Rückgabewert

Diese Funktion gibt S_OK zurück, wenn die Funktion erfolgreich war, S_FALSE , wenn die Pfadzeichenfolge bereits in einem umgekehrten Schrägstrich endet, oder andernfalls mit einem Fehlercode.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile pathcch.h
Bibliothek Pathcch.lib

Weitere Informationen

PathCchAddBackslashEx