Функция PathCchAddBackslash (pathcch.h)

Статья
03/01/2024

Добавляет обратную косую черту в конец строки, чтобы создать правильный синтаксис для пути. Если исходный путь уже имеет завершающую обратную косую черту, обратная косая черта добавляться не будет.

Эта функция отличается от PathCchAddBackslashEx тем, что вы ограничены конечным путем длины MAX_PATH.

Эта функция отличается от PathAddBackslash тем, что она принимает пути с префиксами "\", "\?" и "\?\UNC".

Примечание Эту функцию или PathCchAddBackslashEx следует использовать вместо PathAddBackslash, чтобы предотвратить возможность переполнения буфера.

Синтаксис

WINPATHCCHAPI HRESULT PathCchAddBackslash(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Параметры

[in, out] pszPath

Указатель на строку пути. При успешном выполнении этой функции буфер содержит строку с добавленной обратной косой чертой. Это значение не должно иметь значение NULL.

[in] cchPath

Размер буфера, на который указывает pszPath, в символах.

Возвращаемое значение

Эта функция возвращает S_OK , если функция была успешной, S_FALSE , если строка пути уже заканчивается обратной косой чертой, или код ошибки в противном случае.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	pathcch.h
Библиотека	Pathcch.lib

См. также раздел

PathCchAddBackslashEx

Поделиться через