PathCchRemoveBackslashEx-Funktion (pathcch.h)

Artikel
03/04/2024

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

Diese Funktion unterscheidet sich von PathCchRemoveBackslash darin, dass sie einen Zeiger auf das neue Ende der Zeichenfolge zurückgeben und die Anzahl der im Puffer verbleibenden nicht verwendeten Zeichen melden kann.

Diese Funktion unterscheidet sich von PathRemoveBackslash darin, dass pfade mit den Präfixen "\", "\?" und "\?\UNC" akzeptiert werden.

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

Syntax

WINPATHCCHAPI HRESULT PathCchRemoveBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

Parameter

[in, out] pszPath

Ein Zeiger auf die Pfadzeichenfolge. Wenn diese Funktion erfolgreich zurückgegeben wird, enthält die Zeichenfolge den Pfad, wobei der 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.

[out, optional] ppszEnd

Ein Wert, der nach erfolgreicher Rückgabe dieser Funktion die Adresse eines Zeigers auf das Ende der neuen Zeichenfolge empfängt. Wenn die Zeichenfolge ein Stammpfad wie "C:" ist, zeigt der Zeiger auf den umgekehrten Schrägstrich; Andernfalls zeigt der Zeiger auf das abschließende NULL-Zeichen der Zeichenfolge.

[out, optional] pcchRemaining

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Funktion die Anzahl nicht verwendeter Zeichen im Zielpuffer empfängt, einschließlich des abschließenden NULL-Zeichens. Wenn die Zeichenfolge ein Stammpfad wie "C:" ist, enthält diese Anzahl den umgekehrten Schrägstrich in dieser Zeichenfolge.

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 gefunden wurde, oder andernfalls ein Fehlercode.

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