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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

[in, out] pszPath

Тип: LPTSTR

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

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

Тип: LPTSTR

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

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