PathCchAppendEx-Funktion (pathcch.h)
Fügt einen Pfad an das Ende eines anderen an.
Diese Funktion unterscheidet sich von PathCchAppend dadurch, dass ein längerer endgültiger Pfad erstellt werden kann.
Diese Funktion unterscheidet sich von PathAppend dadurch, dass sie Pfade mit den Präfixen "\", "\?" und "\?\UNC" akzeptiert.
Syntax
WINPATHCCHAPI HRESULT PathCchAppendEx(
[in, out] PWSTR pszPath,
[in] size_t cchPath,
[in, optional] PCWSTR pszMore,
[in] ULONG dwFlags
);
Parameter
[in, out] pszPath
Ein Zeiger auf einen Puffer, der bei der Eingabe 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 an das Ende des Pfads angefügt werden soll, auf den pszPath verweist. UNC-Pfade und Pfade, die mit der Sequenz \?\ beginnen, werden als vollqualifizierte Pfade akzeptiert und erkannt. Diese Pfade ersetzen die Zeichenfolge, auf die von pszPath verwiesen wird, anstatt an sie angefügt zu werden.
[in] dwFlags
Mindestens eins der folgenden Flags:
Rückgabewert
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Code zurückgegeben, einschließlich des folgenden.
Rückgabecode | Beschreibung |
---|---|
|
Entweder pszPath oder pszMore ist NULL, cchPath ist 0 oder cchPath ist größer als PATHCCH_MAX_CCH. |
|
Die resultierende Zeichenfolge würde PATHCCH_MAX_CCH überschreiten. |
|
Die Funktion konnte keinen Puffer der erforderlichen Größe zuordnen. |
Hinweise
Diese Funktion fügt einen umgekehrten Schrägstrich zwischen die beiden Zeichenfolgen ein, sofern noch kein umgekehrter Schrägstrich 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für