PathCchAddBackslashEx-Funktion (pathcch.h)

  • Artikel

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 nachfolgenden umgekehrten Schrägstrich aufweist, wird kein umgekehrter Schrägstrich hinzugefügt.

Diese Funktion unterscheidet sich von PathCchAddBackslash 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 PathAddBackslash darin, dass pfade mit den Präfixen "\", "\?" und "\?\UNC" akzeptiert werden.

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

Syntax

WINPATHCCHAPI HRESULT PathCchAddBackslashEx(
  [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 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.

[out, optional] ppszEnd

Ein Wert, der nach erfolgreicher Rückgabe dieser Funktion die Adresse eines Zeigers auf das abschließende NULL-Zeichen am Ende der Zeichenfolge empfängt.

[out, optional] pcchRemaining

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Funktion auf die Anzahl nicht verwendeter Zeichen im Zielpuffer festgelegt wird, einschließlich des abschließenden NULL-Zeichens.

Rückgabewert

Diese Funktion gibt S_OK zurück, wenn die Funktion erfolgreich war, S_FALSE , wenn die Pfadzeichenfolge bereits mit einem umgekehrten Schrägstrich endet, oder andernfalls einen 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

PathCchAddBackslash