PathCchAddBackslashEx-Funktion (pathcch.h)
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.
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 |