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

Статья
11/20/2024

Копирует и добавляет символы из одной строки в конец другого.

Примечание не использовать. См. примечания для альтернативных функций.

Синтаксис

PWSTR StrCatBuffW(
  [in, out] PWSTR  pszDest,
  [in]      PCWSTR pszSrc,
            int    cchDestBuffSize
);

Параметры

[in, out] pszDest

Тип: PTSTR

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

[in] pszSrc

Тип: PCTSTR

Указатель на строку, добавляемую к pszDest.

cchDestBuffSize

Тип: int

Размер буфера в символах, указывающий на pszDest. Это значение должно быть по крайней мере длиной объединенной строки, а также завершающим символом NULL. Если буфер слишком мал, чтобы соответствовать всей строке, строка будет усечена.

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

Тип: PTSTR

Возвращает указатель на целевую строку.

Замечания

предупреждение системы безопасности: использование этой функции неправильно может скомпрометируйте безопасность приложения. Последняя строка не гарантируется, что она будет завершена null. Попробуйте использовать один из следующих вариантов: StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatNили StringCchCatNEx. Перед продолжением следует просмотреть вопросы безопасности: microsoft Windows Shell.

Заметка

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

Требования

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

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