PathCchAppend-Funktion (pathcch.h)

Artikel
03/04/2024

Fügt einen Pfad an das Ende eines anderen an.

Diese Funktion unterscheidet sich von PathCchAppendEx darin, dass Sie auf einen endgültigen Pfad der Länge MAX_PATH beschränkt sind.

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

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

Syntax

WINPATHCCHAPI HRESULT PathCchAppend(
  [in, out]      PWSTR  pszPath,
  [in]           size_t cchPath,
  [in, optional] PCWSTR pszMore
);

Parameter

[in, out] pszPath

Ein Zeiger auf einen Puffer, der beim Eintrag den ursprünglichen Pfad enthält. Wenn diese Funktion erfolgreich zurückgegeben wird, enthält der Puffer den ursprünglichen Pfad und den angefügten Pfad.

[in] cchPath

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

[in, optional] pszMore

Ein Zeiger auf den Pfad, der am Ende des Pfads angefügt werden soll, auf den pszPath verweist. UNC-Pfade und -Pfade, die mit der Sequenz "\?" beginnen, werden akzeptiert und als vollqualifizierte Pfade erkannt. Diese Pfade ersetzen die Zeichenfolge, auf die von pszPath verwiesen wird, anstatt an sie angefügt zu werden.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Code zurückgegeben, einschließlich des folgenden.

Rückgabecode	Beschreibung
E_INVALIDARG	Entweder pszPath oder pszMore ist NULL, cchPath ist 0, oder cchPath ist größer als PATHCCH_MAX_CCH.
PATHCCH_E_FILENAME_TOO_LONG	Die resultierende Zeichenfolge würde PATHCCH_MAX_CCH überschreiten.
E_OUTOFMEMORY	Die Funktion konnte keinen Puffer der erforderlichen Größe zuordnen.

Hinweise

Diese Funktion fügt einen umgekehrten Schrägstrich zwischen den beiden Zeichenfolgen ein, wenn noch keiner vorhanden ist.

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

PathCchAppendEx

Freigeben über