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


Функция PathAddBackslashA (shlwapi.h)

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

Примечание Неправильное использование этой функции может привести к переполнению буфера. Вместо нее рекомендуется использовать более безопасную функцию PathCchAddBackslash или PathCchAddBackslashEx .
 

Синтаксис

LPSTR PathAddBackslashA(
  [in, out] LPSTR pszPath
);

Параметры

[in, out] pszPath

Тип: LPTSTR

Указатель на буфер со строкой, представляющей путь. Размер этого буфера должен быть установлен в MAX_PATH, чтобы убедиться, что он достаточно велик для хранения возвращаемой строки.

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

Тип: LPTSTR

Указатель, который при успешном возвращении этой функции указывает на завершающий пустой символ новой строки. Если обратную косую черту не удалось добавить из-за недостаточного размера буфера, это значение равно NULL.

Комментарии

Примечание

Заголовок shlwapi.h определяет PathAddBackslash в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 4.71 или более поздняя)