PathCchRemoveBackslash-Funktion (pathcch.h)

Artikel
03/04/2024

Entfernt den nachfolgenden umgekehrten Schrägstrich vom Ende einer Pfadzeichenfolge.

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

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

Syntax

WINPATHCCHAPI HRESULT PathCchRemoveBackslash(
  [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 die Zeichenfolge den Pfad, bei dem jeder nachfolgende umgekehrte Schrägstrich entfernt wurde. Wenn kein nachgestellter umgekehrter Schrägstrich gefunden wurde, bleibt die Zeichenfolge unverändert.

[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 , ob die Zeichenfolge ein Stammpfad war oder wenn kein umgekehrter Schrägstrich oder andernfalls ein Fehlercode gefunden wurde.

Hinweise

Diese Funktion entfernt den umgekehrten Schrägstrich nicht aus einer Stammpfadzeichenfolge, z. B. "C:".

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

Freigeben über